panel
The panel definition creates controls on the desktop. A window instance with the specified window class and data source is created in the panel.
As with any embedded child window instance, window class size tags will be ignored.
The "modes" attribute indicates whether the panel should be created depending on the mode the application is running in. Valid values for this parameter are "host", "client", "local" and "all". Modes can be combined, e.g. "host,client" indicates the panel should be used in both modes. It is possible to define multiple panels with the same name, as long as they don't share the same modes.
Panels can not be closed, moved or resized unless the dynamic tag is specified.
Definition
<panel name="..." modes="..." >
<class > ... </class>
<datasource > ... </datasource>
<bounds > ... </bounds>
<anchored >
<left >
<parent > ... </parent>
<anchor > ... </anchor>
<offset > ... </offset>
</left>
<top > ... </top>
<right > ... </right>
<bottom > ... </bottom>
<size >
<width > ... </width>
<height > ... </height>
</size>
</anchored>
<dynamic />
<locked />
<disabled />
</panel>
<panel name="..." modes="..." > |
|
<class > ... </class> | Specifies the window class of the window instance contained in the panel. |
<datasource > ... </datasource> | Optional. Specifies the data source for the window instance contained in the panel (absolute database path). No tag or missing tag indicates a window not directly tied to a database path/node. |
<bounds > … </bounds> | Defines the position of the panel relative to the desktop. Do not use if <anchored> is defined. |
<anchored > | Defines the position as anchored to other desktop panels. Do not use if <bounds> is defined. |
<left > |
|
<parent > ... </parent> | The name of the panel being anchored to |
<anchor > ... </anchor> | The edge used from the parent panel: "left", "right", "right" or "bottom" |
<offset > ... </offset> | An offset to the calculated anchor position. If a percentage is specified, then a value will be calculated from the width/height of the parent panel or desktop. If a number is specified, then a fixed distance in display units will be used (horizontal for left/right anchors and vertical for top/bottom anchors). |
</left> |
|
<top > ... </top> | Contents similar to the <left> tag |
<right > ... </right> | Contents similar to the <left> tag |
<bottom > ... </bottom> | Contents similar to the <left> tag |
<size > | Defines the size of panels anchored on only one side |
<width > ... </width> | The width of the control, in display units |
<height > ... </height> | The height of the control, in display units |
</size> |
|
</anchored> |
|
<dynamic /> | If defined, the encapsulated windowclass determines whether the panel can be closed, moved or resized. |
<locked /> | If defined with the dynamic tag, the panel can not be closed, moved or resized; until the panel is unlocked via the radial menu. |
<disabled /> | If defined with the disabled tag, the panel can not be interacted with using the mouse or keyboard. All interface events will be ignored. |
</panel> |
|