BUTTON

This Command specifies a Button on the current Menu (as defined by the previous MENU Command Line).

Parameters

ID

Button ID (Number). This should lie in the range 1-256. This Parameter is optional and, if omitted, the next available Button ID for the current Menu will be assigned automatically.

Qualifiers

/COMMENT

Identifies the Button as a Comment Button. Thus it is passive, any Descriptive Text being displayed but the Button ID being treated as invalid as an Operator Response.

/DESCRIPTION=<Text>

Specifies the Descriptive Text on Button. The Text will be converted into upper case unless it it enclosed in quotes. Text containing embedded word separator characters (spaces, commas etc.) should also be enclosed in quotes. The Button will be ignored if the Descriptive Text is null (all spaces).

/RESPONSE=<text>

Specifies the Response Text on Button. The Text will be converted into upper case unless it it enclosed in quotes. Text containing embedded word separator characters (spaces, commas etc.) should also be enclosed in quotes. The response text defaults to null (all spaces) if this Qualifier is absent or has no associated text. This is the normal setup for all menu types except Action Menus where this will cause the Button to act like a Comment Button. A valid Response should either commence with a valid Verb for the Verb Group associated with the currently setup Menu, or a Symbol (with the leading ``\&" character) that translates into a valid Verb, or an Indirect Command File specification (with the leading ``@" character).

/STYLE=<style>

Overrides the default Text Style for the Button. The possible Style attributes are BLINK, BOLD, REVERSE and UNDERLINE and they may be specified using the following syntax:-

/STYLE=(BOLD,REVERSE,...)

\

Omitting the attributes will result in normal Text and the parentheses may be omitted if only a single attribute is desired.

/USER_INFO=<text>

Specifies the User Information Text on Button. The Text will be converted into upper case unless it it enclosed in quotes. Text containing embedded word separator characters (spaces, commas etc.) should also be enclosed in quotes. The user information text is not visible to the user, but may be used by the application programmer to save additional information if so desired.

The currently setup menu must be explicitly specified prior to this via a MENU Command Line. Qualifiers may be attached either to the Keyword or to the Button ID and thus the following is legal:-

BUTTON/COMMENT 4 /DESCRIPTION="Descriptive Text"