The CHAPTER command can be used to control the contents of a dialog page, and to produce a tab. If there is more information than will display within a tab, multiple pages within the tab are automatically created.
The Model Object dialog showing two pages for the Definition tab
Syntax and positioning of CHAPTER command
To create a tab, use the CHAPTER command and specify the name of the tab as an argument (using double quotes around the name if there are embedded spaces). The CHAPTER command does not require opening and closing braces, { }, or a BEGIN .. END statement block.
CHAPTER Name_of_Tab
or
CHAPTER "Name of Tab"
All properties listed in the specification after the CHAPTER command fall in that CHAPTER (or tab), until the next CHAPTER command is encountered. The CHAPTER command may be placed at any point within a diagram, symbol, or definition specification of USRPROPS.TXT, except within a GROUP block.
Note CHAPTER is used for this command instead of the more obvious word TAB because TAB has always had a different meaning in USRPROPS.TXT (it is used in the LAYOUT command).
The following rules are in effect for the CHAPTER command:
▪A property added through USRPROPS.TXT without a CHAPTER command is placed at the end of all definition property statements, and, therefore, on the last page of the last “Definition” tab making up the definition dialog. (Please note that a definition may contain one or more tabs of information tied to the symbol, which come at the very end of the definition dialog. The first of these “symbol” tabs is often named “Symbol”, but may be renamed to another name. The symbol tabs only appear if you open the definition dialog of a symbol on a diagram; if you open a definition from the explorer, they do not appear).
▪You may add a property to an existing tab called out in SAPROPS.CFG by respecifying the tab with a CHAPTER command in USRPROPS.TXT. Properties that you add are placed at the end of that tab in the dialog.
▪Tabs for new CHAPTER commands that you add to existing Diagram, Symbol, or Definition specifications are placed at the end of the dialog, after all pre-existing tabs.
▪If a GROUP command is desired, it must be nested inside a CHAPTER command.
