Inserting New Menu Fields
- Last UpdatedJan 09, 2024
- 1 minute read
You can insert new fields into a menu using the InsertBefore() and InsertAfter() methods, which insert the new fields relative to existing named menu fields.
The methods use named menu fields to determine the point where they should insert the new field.
The general syntax is:
InsertBefore(<TargetFieldName>,<FieldType>,<Dtext>,<Rtext>,{<FieldName>})
InsertBefore(‘SEPARATOR’,{<FieldName>})
InsertAfter(<TargetFieldName>,<FieldType>,<Dtext>,<Rtext>,{<FieldName>})
InsertAfter(‘SEPARATOR’,{<FieldName>})
Where the fields have the following meanings:
|
Field |
Description |
|
<TargetFieldName> |
is the name of the field immediately before or after where you want the new field to go. |
|
<FieldType> |
has allowable values: ‘CALLBACK’, ‘TOGGLE’, ‘MENU’, and ‘FORM’. |
|
<Dtext> |
is the display-text for the field (cannot be null or blank). May contain multi-byte characters. |
|
<Rtext> |
is the replacement-text for the field. A null string indicates no replacement-text. The allowable values for RTEXT for the different field types are: ‘CALLBACK’ - callback string 'TOGGLE’ - callback string ‘MENU’ - menu name string (without preceding ‘.’). It cannot be blank. ‘FORM’ - form name string (without preceding ‘!!’). It cannot be blank. |
|
<FieldName> |
is an optional argument, which, if present, is the unique field name within the menu. |