Window: View Hierarchy

Display in a Tree Structure

The Window tab page of the window editor displays the views that are contained in the window in a tree structure. All of the window's available inbound and outbound plugs are displayed as subnodes of the root element; the available inbound and outbound plugs of the embedded views correspond to their subnodes. Navigation links from a view to a following view are in turn displayed as subnodes of the corresponding outbound plug.

Properties Table of the Window Attribute

You can select every single element of the Window structure by clicking the element. The table at the bottom edge of the screen displays the properties of each selected element.

Default View

In a simple application, the sequence of the views in the navigation is often fixed and there is exactly one view with which the navigation within a window is started. In the Default column you can select such a view as the starting point for the navigation in the window.

If the start view of a window should not be defined until runtime, this is controlled using the event handler method programming of the window's inbound plug . If you determine the start view using the Default field at design time, then it is not necessary to process the window's inbound plug.

Embedding a View

When you create a component, the system automatically creates a view (default name MAIN), and embeds it into the window that is also created automatically. You can also manually embed your views into a window.

1. In the context menu of the root node of the window structure, select Embed View .

   All available views are offered, that is, all views that are not embedded in the current window of the component, as well as all interface views that are not yet embedded from components for which a component usage was declared.

2. Use the F4 help to select the required view.

3. Confirm your entries.

   The view or interface view is added to the window structure.

Alternatively, you can also use the drag and drop technique to embed views in a window structure:

1. In the object tree, expand the node Views to the left of the screen.

2. Select a view.

3. Drag and drop the required view on the root node of your window structure.

   Let go of the left mouse button to insert the view in the tree.

When you insert a view, its inbound and outbound plugs are displayed as child elements of the view in the window's hierarchical structure.

Creating a Navigation Link

Proceed as follows to create a navigation link between two views.

1. In the context men of an outbound plug element, select Create Navigation Link .

   Some administrative data of the view is listed and from which the navigation is to be started.

2. Using F4, select the target view you want from all the views offered for selection in this window.

   Selecting the target view automatically specifies your embedding position within the window also.

3. If the target view has only one inbound plug, then this is automatically entered as the inbound plug for this navigation. If the view has several inbound plugs, however, you have to select the required plug here.

The navigation is created when you close this dialog and it appears in the window's structure as a child element of the outbound plug for which it was set up.