CONTROL

Controls are used to collect user input or to display information on a user interface.

Location

A CONTROL tag can be used within either the EDITORLAYOUT section of a Tag Definition or the PAGELAYOUT section of a Wizard profile file. It can occur either directly within these tags or within a CONTAINER tag.

User interface aspects

Focus:
Which control or tab page receives focus when the editor window is displayed is determined by which corresponding ATTRIB tag occurs first in the ATTRIBUTES section.
Tabbing order:
Determined by the order in which these controls appear in the EDITORLAYOUT or PAGELAYOUT section.

Control types

The following controls can be used in VTML (Label and Image are output-only, all others are input controls):

CONTROL TYPE="Label"

Function

A label can serve as a caption for an input control or to display extra information on the dialog. This is an output-only control.

Syntax and Attributes

<CONTROL TYPE="Label" .../>
CAPTION The text displayed by the label.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
FOCUSCONTROL Associates a label with it's corresponding value control (TextBox, CheckBox, Memo, etc). Used with REQUIRED so that the label can indicate visually that it's corresponding control is required. You can give a label a CAPTION with an ampersand (&) which creates a hot-key for the edit control. Selecting the hot-key forces the cursor to jump to the control named in FOCUSCONTROL.
AUTOSIZE YES/NO. Redundant. Automatically sizes the control to the text it contains. This option is overridden if WIDTH or HEIGHT are explicitly specified; if not, AUTOSIZE is always in operation, regardless whether Yes or No is specified..
TRANSPARENT YES/NO. Makes label transparent. In practice, there seems to be very little difference between transparent or not.
ALIGN LEFT/CENTER/RIGHT. Horizontal alignment of text in the label.
VALIGN TOP/CENTER/BOTTOM. Vertical alignment of text in the label.

Examples

<CONTROL TYPE="Label" NAME="lblSource" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Source:"/>

CONTROL TYPE="TextBox"

Function

A simple textbox control.

Syntax and Attributes

<CONTROL TYPE="TextBox" .../>
VALUE The text displayed by the textbox.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
AUTOSIZE YES/NO. Automatically sizes the control to the text it contains. This option is overridden if WIDTH or HEIGHT are explicitly specified.
Not operational.
EDITABLE YES/NO. Enables/disables editing.
AUTOSELECT FLAG. Decides whether contents get highlighted when cursor enters the textbox.
ALLOWDECIMALPOINT YES/NO (Default unknown). Indicates whether an entered number can contain a decimal point.
Not operational but useful as comment if backed up up by WIZML code.
ALLOWNEGATIVE YES/NO (Default unknown). Indicates whether an entered number can be negative.
Not operational but useful as comment if backed up up by WIZML code.
MAXLENGTH Limits the amount of text in the textbox to a specific number of characters.
PASSWORDCHAR A character to be used to mask entered text. You can create a simple password box using PASSWORDCHAR="*".
CHARCASE NORMAL/UPPER/LOWER. Specifies whether entered text is automatically uppercased or lowercased. The default is NORMAL, preserving entered case.
VALIGN TOP/CENTER/BOTTOM. Horizontal alignment of text in the textbox.

Examples

<CONTROL TYPE="Label" NAME="lblSource" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Source:"/>
<CONTROL TYPE="TextBox" NAME="txtSource" WIDTH="MAXIMUM" VALUE="Some Value" ANCHOR="lblSource" CORNER="NE"/>

CONTROL TYPE="CheckBox"

Function

A simple checkbox control. Returns 'true' or 'false'.

Syntax and Attributes

<CONTROL TYPE="CheckBox" .../>
CAPTION Caption displayed next to the checkbox.
CHECKED FLAG. Specifies initial status.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="CheckBox" NAME="checkNoShading" WIDTH="MAXIMUM"
       ANCHOR="numWidth" CORNER="NE" DOWN=4 RIGHT=20 CAPTION=" No Shading"/>

CONTROL TYPE="DropDown"

Function

A dropdown listbox. This tag requires <ITEM/> sub-tags, which specify the list of items in the drop down. When free text is entered into an editable DropDown, the actual text is considered the value of the control. This control type requires an end tag </CONTROL> to enclose the ITEM sub-tags.

Syntax and Attributes

<CONTROL TYPE="DropDown" ...> </CONTROL>
EDITABLE FLAG. The EDITABLE attribute decides whether it behaves like an editable dropdown combobox or a fixed dropdown listbox.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="Label" NAME="lblAlign" WIDTH=50 ANCHOR="lblSource" CORNER="SW" DOWN=10 CAPTION="Align:"/>

<CONTROL TYPE="DropDown" NAME="dropAlign" WIDTH=100 ANCHOR="lblAlign" CORNER="NE">  
      <ITEM VALUE="TOP"    CAPTION="TOP"/>
      <ITEM VALUE="MIDDLE" CAPTION="MIDDLE" SELECTED/>
      <ITEM VALUE="BOTTOM" CAPTION="BOTTOM"/>
</CONTROL>

CONTROL TYPE="ListBox"VTML 2

Function

A listbox. This tag requires <ITEM/> sub-tags, which specify the list of items in the listbox. This control type requires an end tag </CONTROL> to enclose the ITEM sub-tags. The size of a listbox is determined by its (LF)WIDTH and (LF)HEIGHT attributes.

Syntax and Attributes

<CONTROL TYPE="Listbox" ...> </CONTROL>
MULTISELECT FLAG. The MULTISELECT attribute decides whether the user can select multiple items. When multiple selections are made the control returns the values as a comma-delimited string.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="Label" NAME="lblAlign" WIDTH=50 ANCHOR="lblSource" CORNER="SW" DOWN=10 CAPTION="Align:"/>

<CONTROL TYPE="ListBox" NAME="listAlign" WIDTH=100 ANCHOR="lblAlign" CORNER="NE">  
      <ITEM VALUE="TOP"    CAPTION="TOP"/>
      <ITEM VALUE="MIDDLE" CAPTION="MIDDLE" SELECTED/>
      <ITEM VALUE="BOTTOM" CAPTION="BOTTOM"/>
</CONTROL>

CONTROL TYPE="RadioGroup"

Function

A set of radio buttons. This tag requires <ITEM/> sub-tags, which specify the list of radio buttons. This control type requires an end tag </CONTROL> to enclose the nested ITEM sub-tags.

Syntax and Attributes

<CONTROL TYPE="RadioGroup" ...> </CONTROL>
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="RadioGroup" NAME="radioNameConflict" WIDTH="MAXIMUM"
         ANCHOR="lblAccept" CORNER="SW" DOWN=35 HEIGHT="MAXIMUM" CAPTION="Radio One">
    <ITEM VALUE="ERROR"      CAPTION="ERROR - The file will not be saved and ColdFusion will return an error."
          SELECTED/>
    <ITEM VALUE="SKIP"       CAPTION="SKIP - Neither saves the file nor throws an error."/>
    <ITEM VALUE="OVERWRITE"  CAPTION="OVERWRITE - Replaces the existing file if name conflict occurs."/>
    <ITEM VALUE="MAKEUNIQUE" CAPTION="MAKEUNIQUE - Automatically generates a unique filename for the upload."/>
</CONTROL>

Usage Notes

A radio group is always surrounded by a group box, labelled with the CAPTION; this group box can not be suppressed. The size of the group box is determined (LF)WIDTH and (LF)HEIGHT attributes. The radio buttons will be laid out vertically within this group box, and made to fit to its size which can result in overlapping radio buttons. Horizontal layout is not possible.

CONTROL TYPE="Image"

Function

An image control capable of containing BMP images. BMPs Should be saved as RLE (run-length encoding) to ensure transparency across systems. The lower left pixel determines transparent color. This is an output-only control.

Syntax and Attributes

<CONTROL TYPE="Image" .../>
FILEPATH Path to the image file relative to the Tag definition or Wizard profile file.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
AUTOSIZE YES/NO. Automatically sizes the control to the image it contains. This option is overridden if WIDTH or HEIGHT are explicitly specified.
TRANSPARENT YES/NO. Controls transparency.
CENTER FLAG. Centers the image; works only if both WIDTH and HEIGHT are explicitly specified.

Examples

<CONTROL TYPE="Image" NAME="imgApplet" FILEPATH="Images/Applet.bmp" 
            DOWN=10 RIGHT=10 AUTOSIZE="Yes"/>

CONTROL TYPE="TextArea"

Function

A simple multi-line text entry control.

Syntax and Attributes

<CONTROL TYPE="TextArea" .../>
SCROLLBAR NONE/HORIZONTAL/VERTICAL/BOTH. Specifies which scrollbars should be displayed.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
VALUE Specifies the default text for the control. To force a linefeed, embed "\n" directly within the text.
WRAP FLAG. Enables wrapping of text.
Disabled when a horizontal scrollbar is shown with SCROLLBAR="Horizontal" or SCROLLBAR="Both" even when the flag is present.
DISABLED FLAG. Display an area of text for informational purposes only. The control will be unusable and have a sunken pane effect.

Examples

<CONTROL TYPE="TextArea" NAME="txtContent" WIDTH="MAXIMUM" HEIGHT="MAXIMUM"
        DOWN=5 RIGHT=5 MAXWIDTHPADDING=5 MAXHEIGHTPADDING=5/> 
			

CONTROL TYPE="ImgMapTextArea"VTML 3

Function

A simple multi-line text entry control with an interface to the Image Map editor.

Syntax and Attributes

<CONTROL TYPE="ImgMapTextArea" .../>
SCROLLBAR NONE/HORIZONTAL/VERTICAL/BOTH. Specifies which scrollbars should be displayed.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
VALUE Specifies the default text for the control. To force a linefeed, embed "\n" directly within the text.
WRAP FLAG. Enables wrapping of text.
Disabled when a horizontal scrollbar is shown with SCROLLBAR="Horizontal" or SCROLLBAR="Both" even when the flag is present.
MAPNAMECONTROL Required. The name of the control in the same editor that contains the NAME attribute of the MAP tag.

Examples

<CONTROL TYPE="ImgMapTextArea" NAME="mapContent"
         WIDTH="MAXIMUM" HEIGHT="MAXIMUM" MAXHEIGHTPADDING=5 MAXWIDTHPADDING=5
         RIGHT=5 DOWN=5 MAPNAMECONTROL="txtMapName" SCROLLBAR="both"/>

Usage Notes

This control is used only by Tag Editors. It creates a text area to define AREA tags for an image map, with a button next to it which can call the Image Map Editor. The button code requires the MAPNAMECONTROL attribute to call the Image Map Editor. When the attribute control it refers to already has a value, even when creating a new tag, the Image Map Editor will look for an IMG tag in the same document which has a USEMAP attribute which refers to a MAP tag with this name. The image in the SRC attribute of this IMG tag will then be loaded in the Image Map Editor. If this control is bound to the $$TagBody variable for a MAP Tag Editor, the body of the MAP tag will be displayed in the text area, and passed to the Image Map Editor when editing the MAP tag.

CONTROL TYPE="SQLTextArea"

Function

A multi-line text entry control use to provide an SQL statement. The control contains a button which the user can use to invoke the query builder.

Syntax and Attributes

<CONTROL TYPE="SQLTextArea" .../> (ColdFusion/JRun Studio ONLY)
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
SCROLLBAR NONE/HORIZONTAL/VERTICAL/BOTH. Specifies which scrollbars should be displayed.
VALUE Specifies the default text for the control. To force a linefeed, embed "\n" directly within the text.
WRAP FLAG. Enables wrapping of text.
Disabled when a horizontal scrollbar is shown with SCROLLBAR="Horizontal" or SCROLLBAR="Both" even when the flag is present.
DSNAMECONTROL The name of the control that should be populated with the Data Source name when a query is selected.
QUERYNAMECONTROL The name of the control that should be populated with the Query Name when a query is selected.

Examples

<CONTAINER TYPE="TabPage" NAME="TabPage1" CAPTION="CFQUERY Tag">
     <CONTAINER TYPE="Panel" NAME="Panel1" WIDTH="MAXIMUM" HEIGHT=80 DOWN=5 RIGHT=10>
          <CONTROL TYPE="Label" NAME="lblQueryName" WIDTH=80 CAPTION="Query Name:" DOWN=15 RIGHT=10/>
          <CONTROL TYPE="Label" NAME="lblDataSource" WIDTH=80 ANCHOR="lblQueryName" CORNER="SW" DOWN=10 RIGHT=0 CAPTION="Data Source:"/>
          <CONTROL TYPE="TextBox" NAME="txtQueryName" WIDTH=130 ANCHOR="lblQueryName" CORNER="NE"/>
          <CONTROL TYPE="TextBox" NAME="txtDataSource" WIDTH=130 ANCHOR="lblDataSource" CORNER="NE"/>   
          <CONTROL TYPE="Label" NAME="lblMaxRows" WIDTH=70 ANCHOR="txtQueryName" CORNER="NE" DOWN=0 RIGHT=10 CAPTION="Max Rows:"/>
          <CONTROL TYPE="Label" NAME="lblTimeout" WIDTH=70 ANCHOR="txtDataSource" CORNER="NE" DOWN=0 RIGHT=10 CAPTION="Timeout:"/>
          <CONTROL TYPE="TextBox" NAME="numMaxRows" WIDTH=30 ANCHOR="lblMaxRows" CORNER="NE"/>
          <CONTROL TYPE="TextBox" NAME="numTimeout" WIDTH=30 ANCHOR="lblTimeout" CORNER="NE"/>

          <CONTROL TYPE="CheckBox" NAME="checkDebug" WIDTH="MAXIMUM"
                  ANCHOR="numTimeout" CORNER="NE" RIGHT=10 DOWN=4 CAPTION="Print debug info"/>
     </CONTAINER>

     <CONTROL TYPE="Label" NAME="lblSQLStatement" WIDTH=110
              ANCHOR="Panel1" CORNER="SW"DOWN=10 RIGHT=0 CAPTION="SQL Statement:"/>

     <CONTROL TYPE="SQLTextArea" NAME="txtSQLStatement" WIDTH="MAXIMUM" HEIGHT="MAXIMUM"
              ANCHOR="lblSQLStatement" CORNER="SW" DOWN="8"
              DSNAMECONTROL="txtDataSource" QUERYNAMECONTROL="txtQueryName"/>
</CONTAINER>

CONTROL TYPE="StyleTextBox"VTML 2

Function

A textbox control for entering style properties and interfaces with the Style Editor.

Syntax and Attributes

<CONTROL TYPE="StyleTextBox" .../>
VALUE Specifies the default text for the control. To force a linefeed, embed "\n" directly within the text.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
MAXLENGTH Limits the amount of text in the style textbox to a specific number of characters.

Examples

<CONTROL TYPE="Label" NAME="lblSource" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Source:"/>
<CONTROL TYPE="TextBox" NAME="txtSource" WIDTH="MAXIMUM" VALUE="Some Value" ANCHOR="lblSource" CORNER="NE"/>

Usage Notes

This control creates a text box with a button next to it which can call the style editor TopStyle Lite in inline mode to create or edit the STYLE attribute of a tag. The text box itself remains editable to manually enter or update the style properties.

CONTROL TYPE="StyleTextArea"VTML 2

Function

A multi-line entry control for entering style properties and interfaces with the Style Editor.

Syntax and Attributes

<CONTROL TYPE="StyleTextArea" .../>
SCROLLBAR NONE/HORIZONTAL/VERTICAL/BOTH. Specifies which scrollbars should be displayed.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
VALUE Specifies the default text for the control. To force a linefeed, embed "\n" directly within the text.
WRAP FLAG. Enables wrapping of text.
Disabled when a horizontal scrollbar is shown with SCROLLBAR="Horizontal" or SCROLLBAR="Both" even when the flag is present.
INLINESTYLEVTML 3 YES/NO. Controls whether the Style Editor button edits the contents of the textarea as an inline style or edits the contents as a full style sheet with multiple selectors. The default mode of the Style Editor when called from a Tag Editor is as an in-line style editor, so this attribute must be defined and set to "No" to allow editing of multiple style sheet rules.
Since only a textarea allows multiple lines (a textbox does not), this attribute is valid for StyleTextArea but not for StyleTextBox.

Examples

<CONTROL TYPE="StyleTextArea" NAME="styleContent" WIDTH="MAXIMUM" HEIGHT="MAXIMUM"
         DOWN=5 RIGHT=5 MAXWIDTHPADDING=5 MAXHEIGHTPADDING=5 INLINESTYLE="No"/>

Usage Notes

This control creates a text area with a button next to it which can call the style editor TopStyle Lite in inline mode to create or edit the body of a STYLE tag. To make this editable, the control must be bound to the special $$TagBody variable and the STYLE Tag Definition must have BODYEDITING defined in the TAG tag. The text area itself remains editable to manually enter or update the style rules.

CONTROL TYPE="FontPicker"

Function

A dropdown font picker.

Syntax and Attributes

<CONTROL TYPE="FontPicker" .../>
EDITABLE Obsolete for this control. A font name can always be entered manually into the listbox, that is, it is always editable.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="Label" NAME="lblFace" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Font:"/>
<CONTROL TYPE="FontPicker" NAME="fontFace" WIDTH="MAXIMUM" ANCHOR="lblFace" CORNER="NE"/>

CONTROL TYPE="ColorPicker"

Function

A dropdown color picker. Enables selection of a predefined color or a special color code. Control returns value as a color name or hexadecimal value based on user preference.

Syntax and Attributes

<CONTROL TYPE="ColorPicker" .../>
VALUE Specifies a default color to display in the tag editor.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="Label" NAME="lblColor" WIDTH=50 ANCHOR="lblFace" CORNER="SW" DOWN=10 CAPTION="Color:"/>
<CONTROL TYPE="ColorPicker" NAME="colorColor" VALUE="color value" WIDTH="MAXIMUM" ANCHOR="lblColor" CORNER="NE"/>

CONTROL TYPE="FileBrowser"

Function

A textbox used to enter a file path. The File Open dialog enables both local and remote file selection. If the program is set up to use the standard Windows dialog instead, remote file selection is not possible.

Syntax and Attributes

<CONTROL TYPE="FileBrowser" .../>
FILTER The file filter that should be used by the file/folder browsing dialogs, for example, FILTER="*.jpeg;*.jpg".
In VTML 2 filters are freely definable; in VTML 1 the filter must correspond with one of the predefined filetypes in the program.
FILENAMEONLY FLAG. Specifies that only a filename should be entered in the textbox when a file is specified in a local or remote file dialog. By default, the entire path is pasted. Overrules RELATIVE.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.
RELATIVE FLAG. The control determines the relative path when a file or a folder path is selected. The relative path is calculated relative to the file currently opened. When a new file is being edited, it first has to be saved before relative path can be calculated. By default, absolute path is assumed.
DIRONLY FLAG. Specifies that a folder is being selected. This option will convert the file dialogs accessible from the browse buttons to show a folder-browsing dialog instead. By default, file-browsing is assumed. Overrules file-related attributes.
CAPTION Obsolete. It was intended for the window caption that displays in the file/folder browsing dialogs. For example, CAPTION="Select File You Want Uploaded".

Examples

<CONTROL TYPE="Label" NAME="lblSource" WIDTH=60 DOWN=15 RIGHT=10 CAPTION="Source:"/gt;

<CONTROL TYPE="FileBrowser" NAME="txtSource" WIDTH="MAXIMUM"
         ANCHOR="lblSource" CORNER="NE" 
         RELATIVE FILTER="*.htm;*.html;*.cfml;*.cfm;*.asp"/>

CONTROL TYPE="ActiveX"VTML 2

Function

A container for an embedded ActiveX control. For an ActiveX control to function properly within a tag editor, the ActiveX control must implement four methods:

Syntax and Attributes

<CONTROL TYPE="ActiveX" .../>
PROGID The ProgID of the ActiveX control.
REQUIRED FLAG. Set to YES and turn on Options > Settings > Markup Languages Page > Enforce required attribute validation to disable the tag editor OK button until a value is entered for all required attributes.
REQUIREDINVIEW TRUE/FALSE. Default value is False. Set to True to enforce the REQUIRED flag only when this CONTROL is currently in view. If the CONTROL is out of view, such as on a tab page that is not currently selected, the CONTROL is not considered REQUIRED. It is ignored if REQUIRED is not present.

Examples

<CONTROL TYPE="Label" NAME="lblActiveX" WIDTH=50 DOWN=15 RIGHT=10 CAPTION="Process (CIRC3.OCX):"/>
<CONTROL TYPE="ActiveX" NAME="ctrlActiveX" WIDTH="MAXIMUM" ANCHOR="lblActiveX" CORNER="NE" PROGID="Circ3.Circ3Ctrl.1"/>

top