15. statusBar

<statusBar
  name = NMTOKEN
  helpId = NMTOKEN
>
  Content: [ insert | action | tool | separator ]+
</statusBar>

<insert />

<action
  name = NMTOKEN
/>

<tool
  name = NMTOKEN
  stretch = non negative double : 0
/>

<separator />

Specifies a status bar. A status bar contains references to action and tool elements declared elsewhere in the GUI specification.

The insert child element may be used to extend the previous declaration of the status bar. Without an insert child element, a new declaration for status bar "foo" is understood as being a redefinition of status bar "foo". The insert child element specifies where to insert the items found in the previous declaration. The insert element must be the first or the last child of a statusBar.

Attributes:

name

Required. Unique name identifying the status bar in this GUI specification.

helpId

Online help ID of the status bar.

A tool contained in a status bar can be ``stretched'', that is, it can be enlarged to fill all the available horizontal space. If several tools are to be stretched, the numeric value of the stretch attribute specifies the amount of space given of each of them. A tool with a large stretch attribute is given more space than a tool with a small stretch attribute.

Example: standard status bar:

  <statusBar name="statusBar" helpId="statusBar">
    <tool name="checkValidityTool" />
    <tool name="statusTool" stretch="1" />
    <action name="showLogAction" />
    <tool name="clipboardTool" />
    <tool name="clipboardContentTool" />
  </statusBar>