31. toolBar

<toolBar
  name = NMTOKEN
  insert = non empty token
  replace = non empty token
  replaceEnd = non empty token
>
  Content: [ insert|
             separator | spacer | button | 
             div | span ]*
</toolBar>

<insert />

<separator 
  line = boolean : true
/>

<spacer />

<button
  icon = anyURI
  largeIcon = anyURI
  label = non empty token
  toolTip = non empty token
  group = NMTOKEN
  name = NMTOKEN
>
  Content: [ class [ property ]* ]? command | menu
</button>

<class>
  Content: Java class name
</class>

<property
  name = NMTOKEN matching [_a-zA-Z][_a-zA-Z0-9]*
  type = (boolean|byte|char|short|int|long|float|double|
          String|URL)
  value = string
/>

<command
  name = NMTOKEN (optionally preceded by a command namespace)
  parameter = string
/>

<menu
  name = NMTOKEN
>
  Content: [ item | separator ]+
</menu>

<item
  label = non empty token
  icon = anyURI
  command = NMTOKEN (optionally preceded by a command namespace)
  parameter = string
/>

<div
  label = non empty token
  name = NMTOKEN
>
  Content: [ separator | spacer | button | 
             span ]+
</div>

<span
  name = NMTOKEN
>
  Content: [ separator | spacer | button ]+
</span>

Add buttons specified in this element to one of the tool bars of XMLmind XML editor.

Elements button, menu, item and separator are best explained by reading the example below.
Attribute group of element button may be given a value in order to give a common border to a group of buttons. The buttons belonging to the same group must be all adjacent and must all have the same value of attribute group.
Child elements class and property of element button are explained in Section 31.1, “Custom controls”.
The insert child element, the insert, replace, replaceEnd attributes may be used to customize to the previous definition of a toolBar. More information in Section 19.1, “Customizing a menu or a toolBar without redefining it from scratch”.
The div and span child elements are explained in Section 31.3, “Adding configuration specific tool bar buttons to the XXE GUI”.

Example:

<toolBar>
  <button toolTip="Convert to emphasis" 
          icon="icons/emphasis.png">
    <menu>
      <item label="emphasis" command="convert"
            parameter="[implicitElement] emphasis" />
      <separator />
      <item label="literal" command="convert"
            parameter="[implicitElement] literal" />
    </menu>
  </button>

  <button toolTip="Convert to plain text" icon="icons/plainText.png">
    <command name="convert" parameter="[implicitElement] #text" />
  </button>

  <separator />

  <button name="addParaButton" 
          toolTip="Add para" icon="icons/para.png" 
          label="Add para" largeIcon="icons/32/para.png">
    <command name="add" parameter="after[implicitElement] para" />
  </button>
</toolBar>

The name attribute is only useful to customize the previous definition of a toolBar. More information in Section 19.1, “Customizing a menu or a toolBar without redefining it from scratch”.

The label and largeIcon attributes are considered when the button is copied to a ribbon GUI part in XMLmind XML Editor - Customizing the User Interface. In such case, the largeIcon attribute supersedes the icon attribute. More information in Section 31.3, “Adding configuration specific tool bar buttons to the XXE GUI”.

Attributes label and largeIcon are ignored when the button is copied to in a toolBar GUI part in XMLmind XML Editor - Customizing the User Interface.

XMLmind XML Editor - Configuration and Deployment

31. toolBar