Web Dynpro ViewContainerUIElement API - IWDViewContainerUIElement 

Definition

The ViewContainerUIElement UI element is an area within a view that contains another view.

The UI element does not define its own properties, but inherits all properties from the abstract base classs UIElement.

Like all UI elements, the ViewContainerUIElement has the visible property to control its visibility within the view layout. The visible property can have one of the following three values: none, blank, and visible.

 

The properties enabled and tooltip are ignored and do not affect the browser.

Description of the UI Element Properties

·        visible
Specifies the visibility of the UI element in the view layout. The default value of this property is visible.
The visible property can be filled with the following values and is represented by the enumeration type WDVisibilty.

blank	The UI element is not visible on the screen but takes up space.
none	The UI element is not visible on the screen and takes up no space.
visible	The UI element is displayed on the screen.

Overview of Inherited and Additional Properties

Name	Interface	Type	Initial Value	Bindable	Value Required
enabled	IWDUIElement	boolean	true	bindable	No
tooltip	IWDUIElement	String		bindable	No
visible	IWDUIElement	WDVisibility	visible	bindable	No

Performance Considerations

When passing view layout information to the Web Browser, the Web Dynpro runtime environment checks whether or not the current view assembly contains non-visible or empty UI elements of the type ViewContainerUIElement with the visibility property value none or blank. If these values are set, the embedded views and their UI elements are not sent to the Web Browser. This reduces the round trip times and improves the performance of the application.

The optimization of the round trip times is only supported when the visibility property is bound to a context attribute of the type WDVisibility and the readOnly property of the context attribute is set to the value true.

 

Round trip times can be optimized for the visibility property of the UI element ViewContainerUIElement but not for other UI containers like the Group UI element or the Tray UI element. The UI elements they contain are passed to the Web Browser regardless of the visibility property.

Separate views should be used in applications that use the visibility property to display and hide UI elements using data binding. These views can be embedded into the view composition using the UI element ViewContainerUIElement. Especially when only one or two of many ViewContainerUIElement UI elements are to be displayed the optimazation reduces the round trip times considerately.

For detailed information, refer to the tutorial Using ViewContainerUIElements under Using ViewContainerUIElements.

Mobile Characteristics

The UI element ViewContainerUIElement supports the development of mobile applications for pocket PCs and BlackBerry wireless handhelds (see Mobile Web Dynpro).

However, several properties supported in the desktop browser cannot be used. These include:

Variances of the properties

Properties	Pocket PC	BlackBerry wireless handheld
enabled	ignored	ignored
tooltip	ignored	ignored