CAT

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:

Tutorial
The Visual Tool Markup Language (VTML)
Reference
VTML reference - overview
Container for
E

top

Tools

CAT plays a role in the following VTML-driven tools:

  1. Tag Chooser
  2. Expression Builder
  3. Function Insight

top


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.

top


Function

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

top


Syntax and Attributes

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.
 
Tag Chooser: Even if this flag is absent (or set to "No"), in HomeSite the category with caption "HTML Tags"  is always expanded on startup, while in ColdFusion Studio the category with caption "CFML Tags"  is always expanded on startup.
Expression Builder: Works as expected, regardless of Caption.
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