ArcPad Map File Schema
COMBOBOX Element
See Also Send comments on this topic.

ArcPad Map File Schema > PAGE Element : COMBOBOX Element

Glossary Item Box

Description

Used to define a ComboBox control in a form.

Diagram

Overview

COMBOBOX

Used to define a ComboBox control in a form.

height required Restriction of xs:int

width required Restriction of xs:int

x required xs:int

The x coordinate of the upper left corner of the combo box.

y required xs:gYearMonth

The y coordinate of the upper left corner of the combo box

backgroundcolor optional xs:string

border optional Restriction of xs:string

color optional xs:string

defaultvalue optional xs:string

field optional xs:string

font optional xs:string

Font name. The name is case sensitive. If font name uses "&", use "&" instead. For example, ESRI Transportation & Civic should be written as ESRI Transportation & Civic.

fontsize optional Restriction of xs:int

Font size.

fontstyle optional Restriction of xs:string

Font style. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline")

group optional Restriction of xs:string

limittolist optional Restriction of xs:string

listtable optional xs:string

listtextfield optional xs:string

listvaluefield optional xs:string

maxvalue optional xs:string

name optional xs:string

When parent is ToolButton:

Custom tool name. Used to reference the tool in scripts.

onchange optional xs:string

Specify the script to run when this event occurs.

oncloseup optional xs:string

Specify the script to run when this event occurs.

ondropdown optional xs:string

Specify the script to run when this event occurs.

onkillfocus optional xs:string

Specify the script to run when this event occurs.

onselcancel optional xs:string

Specify the script to run when this event occurs.

onselchange optional xs:string

Specify the script to run when this event occurs.

onselok optional xs:string

Specify the script to run when this event occurs.

onsetfocus optional xs:string

Specify the script to run when this event occurs.

onvalidate optional xs:string

Specify the script to run when this event occurs.

readonly optional Restriction of xs:string

required optional Restriction of xs:string

sip optional Restriction of xs:string

sort optional Restriction of xs:string

tabstop optional Restriction of xs:string

Sequence

LISTITEM 1..∞

Used to define an item in a ComboBox or ListBox form control.

Attributes

Name	Type	Use	Default	Fixed	Description
height	Restriction of xs:int	required
width	Restriction of xs:int	required
x	xs:int	required			The x coordinate of the upper left corner of the combo box.
y	xs:gYearMonth	required			The y coordinate of the upper left corner of the combo box
backgroundcolor	xs:string	optional
border	Restriction of xs:string	optional	false
color	xs:string	optional
defaultvalue	xs:string	optional
field	xs:string	optional
font	xs:string	optional			Font name. The name is case sensitive. If font name uses "&", use "&" instead. For example, ESRI Transportation & Civic should be written as ESRI Transportation & Civic.
fontsize	Restriction of xs:int	optional			Font size.
fontstyle	Restriction of xs:string	optional	regular		Font style. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline")
group	Restriction of xs:string	optional	false
limittolist	Restriction of xs:string	optional	true
listtable	xs:string	optional
listtextfield	xs:string	optional
listvaluefield	xs:string	optional
maxvalue	xs:string	optional
name	xs:string	optional			When parent is ToolButton: Custom tool name. Used to reference the tool in scripts.
onchange	xs:string	optional			Specify the script to run when this event occurs.
oncloseup	xs:string	optional			Specify the script to run when this event occurs.
ondropdown	xs:string	optional			Specify the script to run when this event occurs.
onkillfocus	xs:string	optional			Specify the script to run when this event occurs.
onselcancel	xs:string	optional			Specify the script to run when this event occurs.
onselchange	xs:string	optional			Specify the script to run when this event occurs.
onselok	xs:string	optional			Specify the script to run when this event occurs.
onsetfocus	xs:string	optional			Specify the script to run when this event occurs.
onvalidate	xs:string	optional			Specify the script to run when this event occurs.
readonly	Restriction of xs:string	optional	false
required	Restriction of xs:string	optional	false
sip	Restriction of xs:string	optional
sort	Restriction of xs:string	optional	true
tabstop	Restriction of xs:string	optional	true

Examples

ArcPad layer file (*.apl) with an edit form and an identify form.

Restrictions

The following attributes can only be used in edit and identify forms. They cannot be used in general forms:

field
required

Source

<xs:element name="COMBOBOX" maxOccurs="1" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>Used to define a ComboBox control in a form.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:sequence>
      <xs:element ref="LISTITEM" maxOccurs="unbounded" />
    </xs:sequence>
    <xs:attribute use="required" ref="height">
      <xs:annotation>
        <xs:documentation>The height of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" ref="width">
      <xs:annotation>
        <xs:documentation>The width of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="x" type="xs:int">
      <xs:annotation>
        <xs:documentation>The x coordinate of the upper left corner of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute use="required" name="y" type="xs:gYearMonth">
      <xs:annotation>
        <xs:documentation>The y coordinate of the upper left corner of the combo box</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="backgroundcolor">
      <xs:annotation>
        <xs:documentation>The background color to use for the combo box. If not specified, this value is inherited from the page's backgroundcolor attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="border">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box has a border.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="color">
      <xs:annotation>
        <xs:documentation>The color to use for the combo box's text. If not specified, this value is inherited from the page's color attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="defaultvalue">
      <xs:annotation>
        <xs:documentation>A simple expression that specifies the default value of the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="field">
      <xs:annotation>
        <xs:documentation>The field of the shapefile's DBF table that is linked to the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="font">
      <xs:annotation>
        <xs:documentation>The font to use for the combo box's text. If not specified, this value is inherited from the page's font attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="fontsize">
      <xs:annotation>
        <xs:documentation>The font size to use for the combo box's text. If not specified, this value is inherited from the page's fontsize attribute.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="regular" ref="fontstyle">
      <xs:annotation>
        <xs:documentation>The font style to use for the combo box's text. If not specified, this value is inherited from the page's fontstyle attribute. If the value is not regular, it can be any combination of other values, expressed as a comma delimited list (for example, fontstyle="bold,underline").</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="group">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box starts a new group of controls.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="limittolist" />
    <xs:attribute ref="listtable" />
    <xs:attribute ref="listtextfield" />
    <xs:attribute ref="listvaluefield" />
    <xs:attribute ref="maxvalue" />
    <xs:attribute ref="name" />
    <xs:attribute ref="onchange" />
    <xs:attribute ref="oncloseup" />
    <xs:attribute ref="ondropdown" />
    <xs:attribute ref="onkillfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onselcancel" />
    <xs:attribute ref="onselchange" />
    <xs:attribute ref="onselok" />
    <xs:attribute ref="onsetfocus">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute ref="onvalidate">
      <xs:annotation>
        <xs:documentation>Specify the script to run when this event occurs.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="readonly">
      <xs:annotation>
        <xs:documentation>Specifies whether the combo box's value can be modified by the user.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="false" ref="required">
      <xs:annotation>
        <xs:documentation>Specifies if the user must enter some text in the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute default="true" ref="sip" />
    <xs:attribute ref="sort" />
    <xs:attribute default="true" ref="tabstop">
      <xs:annotation>
        <xs:documentation>Specifies whether the TAB key can be used to move the focus to the combo box.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

See Also

PAGE Element | ArcPad Map File Schema

© 2012 All Rights Reserved.