Back Help

<dockbar>

This element defines a docking bar, called a "panel" in the application's user interface. This element must be closed. A docking bar has its own GUID but since an application user can generate his or her own panels, the GUID is generated on the fly. You don't have to worry about this unless you wish to manually create a docking bar by editing an XML file. If that is the case, use a ScenomePlatform application to generate a GUID. Docking bar elements contain editors such as the hierarchy editor, material editor, and property editor.

Attribute Value
name String, "Primary Panel"
GUID String, "{89BA8C40-0FCD-41BE-A59A-FF699CA45070}"
dockposition String, "top", "bottom", "left", "right", "float", "right,top", "left,top", etc.
  • Top. Docks the panel on the top of the desktop.
  • Bottom. Docks the panel on the bottom of the desktop.
  • Left. Docks the panel on the left side of the desktop.
  • Right. Docks the panel on the right side of the desktop.
  • Float. Floats the panel over the desktop.
  • Top,Left. Docks the panel above any other panel already docked on the left.
  • Bottom,Left. Docks the panel below any other panel already docked on the left.
  • Top,Right. Docks the panel above any other panel already docked on the right.
  • Bottom,Right. Docks the panel below any other panel already docked on the right.

Examples

Several examples are provided below.

  1. The following example shows how to define a <dockingbar> element. 
    <dockbar name="Primary Panel" guid="{89BA8C40-0FCD-41BE-A59A-FF699CA45070}"></dockbar>
  2. The following example shows how to create a docking bar "panel" containing three editors. 
    <dockbar name="Primary Panel" guid="{89BA8C40-0FCD-41BE-A59A-FF699CA45070}" position="left,top">
   <dockedview name="Hierarchy" guid="{1F91F9F6-F612-46D4-A453-4B81096121A9}"/> 
   <dockedview name="Materials" guid="{1F922102-F612-46D4-A453-4B81096121A9}"/> 
   <dockedview name="Enumerate" guid="{1F922100-F612-46D4-A453-4B81096121A9}"/> 
   <activeview guid="{1F91F9F6-F612-46D4-A453-4B81096121A9}"/> 
</dockbar>
  3. The following example shows the resulting panel and editors. This is a dockbar.

Configurations

ScenomePlatform is capable of storing the following configurations in XML. Other configurations are available but not via configuration from XML.

Figure 1.1. Docking Positions. dockposition="left,top" and dockposition="left,bottom" Dockbar configuration.

Figure 1.2. Docking Positions. dockposition="right,top" and dockposition="right,bottom" Dockbar configuration.

Figure 1.3. Docking Positions. dockposition="left" Dockbar configuration.

Figure 1.4. Docking Positions. dockposition="right" Dockbar configuration.

Figure 1.5. Docking Positions. dockposition="bottom" Dockbar configuration.

Figure 1.6. Docking Positions. dockposition="top" Dockbar configuration.

Figure 1.7. Docking Positions. dockposition="bottom,left" and dockposition="bottom,right" Dockbar configuration.

Figure 1.8. Docking Positions. dockposition="top,left" and dockposition="top,right" Dockbar configuration.