The CAT tag is used to define a category in a category tree.
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) and in the Expression Builder (ExpressionElements.vtm) to categorize tags, by tag-based language or by purpose.
The difference between the two trees is semantic only; while for the Tag Chooser you create categories of tags, for Expression Builder you create categories of expression elements, such as functions, constants and operators. The ExpressionElements.vtm file contains definitions used in ColdFusion Markup Language (CFML) application development. 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, for building a tree, or E tags.
<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. Alternately, 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. |