ArcPad Preferences File Schema
TOOLBUTTON Element
See Also  Send comments on this topic.
ArcPad Preferences File Schema > TOOLBAR Element : TOOLBUTTON Element

Glossary Item Box

Description

Used to define a custom toolbutton or specify a built-in toolbutton in a toolbar.

Diagram

MENUITEM Element Sequence TOOLBUTTON Element

Overview

TOOLBUTTON 1..∞
Used to define a custom toolbutton or specify a built-in toolbutton in a toolbar.
command optional xs:string
image optional xs:string
name optional xs:string
shortcut optional xs:string
onclick optional xs:string
Specify the script to run when this event occurs.
onpointerdown optional xs:string
Specify the script to run when this event occurs.
onpointermove optional xs:string
Specify the script to run when this event occurs.
onpointerup optional xs:string
Specify the script to run when this event occurs.
prompt optional xs:string
tooltip optional xs:string
Sequence
MENUITEM 1..∞
Used to define a custom toolbutton or specify a built-in toolbutton in a pull-down menu.
caption optional xs:string
command optional xs:string
image optional xs:string
name optional xs:string
onclick optional xs:string
Specify the script to run when this event occurs.
onpointerdown optional xs:string
Specify the script to run when this event occurs.
onpointermove optional xs:string
Specify the script to run when this event occurs.
onpointerup optional xs:string
Specify the script to run when this event occurs.
promote optional Restriction of xs:string
prompt optional xs:string
shortcut optional xs:string

Attributes

NameTypeUseDefaultFixedDescription
commandxs:stringoptional   
imagexs:stringoptional   
namexs:stringoptional   
shortcutxs:stringoptional   
onclickxs:stringoptional  Specify the script to run when this event occurs.
onpointerdownxs:stringoptional  Specify the script to run when this event occurs.
onpointermovexs:stringoptional  Specify the script to run when this event occurs.
onpointerupxs:stringoptional  Specify the script to run when this event occurs.
promptxs:stringoptional   
tooltipxs:stringoptional   

Remarks

  • Use command to specify a built-in tool.
  • Use image, name, prompt, tooltip, and shortcut to specify a user-defined tool and onclick, onpointerdown, onpointermove, and onpointerup to handle events associated with the user-defined tool.

Examples

Restrictions

  • If command is used, image, name, prompt, tooltip, shortcut, onclick, onpointerdown, onpointermove, and onpointerup cannot also be used.
  • If image, name, prompt, tooltip, shortcut, onclick, onpointerdown, onpointermove, or onpointerup is used, command cannot also be used.

Source

<xs:element maxOccurs="unbounded" name="TOOLBUTTON" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexType>
    <xs:sequence>
      <xs:element maxOccurs="unbounded" name="MENUITEM">
        <xs:complexType>
          <xs:attribute ref="caption" />
          <xs:attribute ref="command" />
          <xs:attribute ref="image" />
          <xs:attribute ref="name" />
          <xs:attribute ref="onclick" />
          <xs:attribute ref="onpointerdown" />
          <xs:attribute ref="onpointermove" />
          <xs:attribute ref="onpointerup" />
          <xs:attribute default="false" name="promote">
            <xs:simpleType>
              <xs:restriction base="xs:string">
                <xs:enumeration value="true" />
                <xs:enumeration value="false" />
              </xs:restriction>
            </xs:simpleType>
          </xs:attribute>
          <xs:attribute ref="prompt" />
          <xs:attribute ref="shortcut" />
        </xs:complexType>
      </xs:element>
    </xs:sequence>
    <xs:attribute ref="command" />
    <xs:attribute ref="image" />
    <xs:attribute ref="name" />
    <xs:attribute ref="shortcut" />
    <xs:attribute ref="onclick" />
    <xs:attribute ref="onpointerdown" />
    <xs:attribute ref="onpointermove" />
    <xs:attribute ref="onpointerup" />
    <xs:attribute ref="prompt" />
    <xs:attribute ref="tooltip" />
  </xs:complexType>
</xs:element>

See Also

© 2012 All Rights Reserved.