<categorychooser>

A custom control, used to allow the user to select a list or list(s) with which the record should be

associated. As with the <select> and <select1> tags, the appearance attribute enables you to determine what kind of control is generated at run-time: You can choose from a drop-down list box or a multi-select listbox.

ATTRIBUTES:

ref	Name of the field whose value you wish to insert (Required) [String value] Names must begin with a letter and may only include letters, numbers and the underscore character.
class	Name of the CSS Class used to style the text box (Optional) [String value]
appearance	Used to indicate the appearance of the control at runtime (Optional) [String value] Use this attribute to indicate the type of control that should be created. Possible values are: - compact: Generates a Multi-Select List Box - minimal: Generates a Drop-Down List Box If appearance isn't specified, "compact" is assumed.
style	Same as the HTML style attribute.It allows you to apply CSS styling to the element (e.g. "color: red; border: solid 1px black;") (Optional). [String value]
required	If true, the user will be required to enter a value (Optional) [true or false]
errormessage	If the field is required but has not been filled out by the user, XMod will display the contents of this attribute. If this attribute isn't specified, XMod will default to "FieldName Is Required" (Optional) (new to version 3.0)

ADDITIONAL ATTRIBUTES (New to Version 4.0)

accesskey	In browsers that support it, this property can be set to a character on the keyboard that can be used to set focus to the control. For instance, setting the value to F allows the user to access the control by pressing Alt+F on their keyboard (for Windows machines)
backcolor	Color of the background of the control.
enabled	Whether the control accepts input. May not work in older browsers. Valid values are true and false. The default value is true.
Font Properties	A series of attributes such as font-bold, font-size, etc. that allow you to control how the text in the control is displayed. Click the link for more for the list of properties and their description.
forecolor	Color of the text within the control.
height	The height of the control, specified in units
rows	A numeric value greater than or equal to 1 that determines the number of rows to display in a list box. Applies only if appearance = "compact" (multi-select listbox)
tabindex	The tab order of the control.
width	The width of the control, specified in units.
Client-Side Events	Javascript can be attached to certain events raised by this control. Click the link for more information.

CHILD TAGS

label	The caption used to identify the control
info	This child tag can be used for most anything but is typically used to display more information (usually in a help-related context) about the data entry item.

ATTRIBUTES <info>:

See <info> tag topic

EXAMPLE

<label>Choose A Category: </label>

</categorychooser>