![]() ![]() ![]() |
The structure of the MARKUPTAGS.VTM and EXPRESSIONELEMENTS.VTM files is very simple. They both contain a set of category and element tags. Category tags can contain any number of elements or other nested category tags.
<CAT ... main category > <CAT ... sub-category No.1 > <E ... > <E ... > <E ... > </CAT> <CAT ... sub-category No.2 > <E ... > <E ... > </CAT> </CAT>
Every category represents a category in the category tree located on the left-hand side of the dialogs. The elements in turn represent the tags or expression elements included under each category. The following sections explain how to create and update category and element tags.
The CAT tag is used to define a category in the category tree. The following attributes can be used in the category tags.
Category Tag <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. In addition, a relative file path can be provided to a custom BMP image (ICON ="images/custom.bmp"). By default the Folder icon is displayed. |
EXPANDED | YES\NO Indicates that the category tree-item should be expanded the first time the dialog is displayed. By default, this value is set to NO. |
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. By default. this value is set to YES. |
The E tag is used to define elements within a category. These elements are either Tags in the Tag Chooser or Expression Elements in the Expression Builder.
The following attributes define the behavior of an element:
Element Tag <E ... > | |
---|---|
CAPTION | The caption of the element. |
VALUE | Tag Chooser -- This value represents the tag string pasted when the tag is selected. If a visual editor exists for the tag, an incomplete tag string should be used to invoke the editor. For example, VALUE="MATED" would invoke the visual tag editor for MYTAG stored in MYTAG.VTM. Expression Builder - This value represents the syntax of the expression element to be pasted into the expression textbox. |
DESC | The contents of the HTML help for the element. 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 element. (HELPFILE = "Docs/MyTag.htm") |
![]() ![]() ![]() |
AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.