OfficeControl-Eigenschaften 

Eigenschaften im View Designer

●      activateInPlace

Steuert, ob das Dokument im Browser-Fenster dargestellt wird oder ob zur Darstellung die mit dem Dokumenttyp verknüpfte Office-Anwendung in einem separaten Fenster geöffnet wird. Wenn Sie der EigenschaftactivateInPlace den Wert false und der Eigenschaft documentType den Wert ms_wordzugeordnet haben, öffnet sich beispielsweise das Programm Microsoft Word und stellt den Inhalt in der Benutzungsoberfläche von Microsoft Word dar. Der Standardwert für diese Eigenschaft ist true.

Wenn Sie dieser Eigenschaft den Wert false zugeordnet haben, dann sollten Sie darauf achten, dass Sie den Eigenschaften height und width kleine Werte zuordnen, da diese Werte nicht ignoriert werden und in der View der Web-Dynpro-Anwendung diese Angaben wie Platzhalter wirken. Das Oberflächenelement nimmt in der View genau soviel Raum ein, auf dem nichts dargestellt wird, wie Sie für die Werte der Eigenschaften height und width angegeben haben. Sie sollten daher die Default-Werte 300 mit einer kleineren Zahl, z.B. 5, überschreiben.
Wenn Sie dieser Eigenschaft den Wert true zugeordnet haben, dann sollten Sie zur Anzeige des Dokuments angemessene Werte verwenden, damit das Dokument lesbar ist und nicht zuviel geblättert werden muss, da ein Vergrößern des Dokuments im Browser-Fenster zur Laufzeit nicht möglich ist.

●      controlId

Der Wert für diese Eigenschaft wird automatisch gesetzt. Geben Sie daher hier nichts ein.

●      dataSource

Datenquelle. Sie können hiermit den Pfad zum Context-Attribut spezifizieren, das die Daten zur Verfügung stellt.

Wird diese Property nicht gebunden, so wird im nicht-Expertenmodus automatisch ein neues Dokument angelegt. Im Expertenmodus führt die Ausführung der Methode opendocument zu einem Fehler. Es ist nur die korrekte Ausführung der Methode createdocument möglich.

Primäre Eigenschaft

●      documentName

Name des Dokuments

●      documentType

Typ des Dokuments, das angezeigt werden soll

Wert	Beschreibung
ms_excel	Microsoft-Word-Dokument mit der Erweiterung xls
ms_word	Microsoft-Word-Dokument mit der Erweiterung doc

●      enableReadWrite

Diese Eigenschaft ist deprecated.

Modus des zu öffnenden Dokuments: Steuerung, ob das Dokument editiert und mit geändertem Inhalt zurückgeschrieben werden kann.

●      expertMode

Expertenmodus für komplexe Operationen (Methoden, die in den Interfaces enthalten sind). Wenn Sie diese Eigenschaft auf true setzen, stehen zusätzliche Methoden-Aufrufe zur Verfügung.

Sie erhalten vom OfficeControl eine Factory:

wd_this->factory ?= office->_method_handler.

Diese Factory ist in der Lage, die jeweiligen Proxies zu erzeugen. Auf diesem Proxy können dann die entsprechenden Methoden gerufen werden.

Der Anwendunsentwickler arbeitet nur mit den Interfaces, das Erzeugen der Klassen erfolgt automatisch von Web Dynpro.

 

Die freigegebenen Interfaces sind im Paket sios:

Diese sind generische Interfaces für Frontends (Web Dynpro ABAP, im Web Dynpro Java sind diese entsprechend realisiert).

○       IF_IOS_FACTORY

Factory zum Anlegen aller jeweiligen Proxies

Es stehen nicht alle Methoden für Web Dynpro zur Verfügung. Die Methoden if_ios_factory~set* werden von Web Dynpro automatisch aufgerufen, so dass eine Benutzung dieser Methoden bei Web Dynpro nicht möglich ist, in diesem Fall wird eine Exception geworfen.

○       IF_IOS_DOCUMENT

Grundlegende Operationen auf Dokumenten

○       IF_IOS_ENVIRONMENT

Umgebungsinformationen wie Inplace, Outplace, Tracing aktivieren, Abfrage vorhandener Applikationen am aktuellen Client

Jede Interfacemethode wirft automatisch im Fehlerfall eine Exception.

Jedem Interface ist eine eigene Exception-Klasse zugeordnet: IF_IOS_DOCUMENT : CX_IOS_DOCUMENT.

Diese leiten alle von CX_IOS_EXCEPTION ab. Der Fehlertext wird über IF_T100_MESSAGE zur Verfügung gestellt. Die Basisklasse bietet dann Methoden zum Auslesen dieses Textes.

●      showDecoration

Ein- und Ausblenden von Menüs