Contents
Index
Search

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.

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"1 
          toolTip="Add para" icon="icons/para.png" 
          label="Add para" largeIcon="icons/32/para.png"2>
    <command name="add" parameter="after[implicitElement] para" />
  </button>
</toolBar>

1

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”.

2

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.