The CAT tag is used to define a category in a category tree.
The following subjects are covered in this document:
Related information about VTML and WIZML:
|
CAT plays a role in the following VTML-driven tools:
This tag can occur only in a Tag Chooser or Expression Builder definition file, either as one of the outermost tags, or within another CAT tag.
A category tree is used in the Tag Chooser (MarkUpTags.vtm), to categorize tags, for instance by tag-based language and by purpose.
It is also used in the Expression Builder (ExpressionElements.vtm). The difference is semantic only: while for the Tag Chooser you create categories of tags, for Expression builder you create categories of expression elements, like functions, constants or operators: all the elements that together make a language. The ExpressionElements.vtm file that comes with HomeSite and ColdFusion/Jrun Studio (not surprisingly) contains definitions tailored to CFML. You can easily create your own definitions for any other language by editing or replacing this file.
The CAT tag is a container. It can contain other CAT tags (building a tree) or E tags.
Defaults indicated in bold.
<CAT ...> </CAT> | |
---|---|
CAPTION | The caption of the category. |
DESC | The contents of the HTML help for the category. Notice that the HELPFILE attribute can be used to specify the help as a separate file. |
HELPFILE | The relative path to the HTML help for the category. (HELPFILE="Docs/MyTag.htm") |
ICON | "Folder"/"Elements"/RelativeFilePath. Defines the icon used for the category. You can use a pre-defined Folder or Elements category. Alternatively a relative file path can be provided to a custom BMP image (ICON="images/custom.bmp"). |
EXPANDED | FLAG. Indicates that the category tree-item should be expanded the first time the dialog is displayed. |
SHOWSUBELEMENTS | YES/NO. Indicates that when selected the elements of its sub-categories will also be displayed on the right-hand side. For example, when the "HTML Tags" category is selected the right hand side displays all the tags included in all the HTML tag sub-categories. |