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

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