CAT

The CAT tag is used to define a category in a category tree.

Location

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.

Function

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.

Syntax and Attributes

<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.

top