OfficeControl Properties 

Properties in the View Designer

●      activateInPlace

Controls whether the document appears in the browser window, or the system opens the Office application linked to the document type in a separate window. If you have assigned the value false to the activateInPlace property and the value ms_word to the documentType property, the Microsoft Word application opens and displays the content in the Microsoft Word user interface. The default value for this property is true.

If you have assigned the value false to this property, you should then make sure that you assign small values to the height and width properties, because these values are not ignored and act as placeholders in the view of the Web Dynpro application. In the view, the UI element takes up as much empty space as you have specified for the values of the height and width properties. You should therefore overwrite the default value of 300 with a smaller one, such as 5.
If you have assigned the value true to this property, you should use suitable values for displaying the document, so that the document is readable and the user does not have to scroll too often, because he or she cannot increase the size of the document in the browser window at runtime.

●      controlId

The value of this property is set automatically. Do not enter anything here.

●      dataSource

Data source You can specify the path to the context attribute that makes the data available here.

If this property is not bound, a new document is automatically created in the non-expert mode. In expert mode, the execution of the opendocument method results in an error. Only the createdocument method can be executed correctly.

Primary Property

●      documentName

Name of the document.

●      documentType

Type of the document to be displayed.

Value	Description
ms_excel	Microsoft Word document with the file extension xls
ms_word	Microsoft Word document with the file extension doc

●      enableReadWrite

This property is deprecated.

Mode of the document to be opened. Controls whether the user can edit the document and save it back with changed content.

●      expertMode

Expert mode for complex operations (methods contained in the interfaces). If you set this property to true, additional method calls are available.

You receive a factory from the OfficeControl:

wd_this->factory ?= office->_method_handler.

This factory is able to generate the relevant proxies. The corresponding methods can then be called using the proxy in question.

Application developers work with the interfaces only; classes are created automatically by Web Dynpro.

 

The released interfaces are in the sios package:

These are generic interfaces for front ends (Web Dynpro ABAP, in Web Dynpro Java they are implemented accordingly).

○       IF_IOS_FACTORY

Factory for creating all required proxies.

Not all methods are available for Web Dynpro. The if_ios_factory~set* methods are automatically called by Web Dynpro and thus cannot be used for Web Dynpro, since an exception would be thrown.

○       IF_IOS_DOCUMENT

Basic operations performed on documents.

○       IF_IOS_ENVIRONMENT

Information on the environment such as inplace, outplace, activate tracing, and ascertain available applications in the current client.

Each interface method automatically raises an exception if there is an error.

Each interface is assigned its own exception class: IF_IOS_DOCUMENT : CX_IOS_DOCUMENT.

These all derive from CX_IOS_EXCEPTION. The error text can be found in IF_T100_MESSAGE. The base class offers methods for reading this text.

●      showDecoration

Showing and hiding menus.