Chapter Contents

Previous

Next
The PMENU Procedure

DIALOG Statement


Describes a dialog box that is associated with an item on a pull-down menu.

Restriction: Must be followed by at least one TEXT statement.
Featured in: Collecting User Input in a Dialog Box , Creating a Dialog Box to Search Multiple Variables , and Creating Menus for a DATA Step Window Application


DIALOG dialog-box 'command-string
field-number-specification
';


Required Arguments

command-string
is the command or partial command that is executed when the item is selected. The limit of the command-string that results after the substitutions are made is the command-line limit for your operating environment. Typically, the command-line limit is approximately 80 characters.

The limit for 'command-string field-number-specification' is 200 characters.

Note:    If you are using PROC PMENU to submit any command that is valid only in the PROGRAM EDITOR window (such as the INCLUDE command), you must have the windowing environment running, and you must return control to the PROGRAM EDITOR window.  [cautionend]

dialog-box
is the same name specified for the DIALOG= option in a previous ITEM statement.

field-number-specification
can be one or more of the following:
@1...@n %1...%n &1...&n

You can embed the field numbers, for example @1, %1, or &1, in the command string and mix different types of field numbers within a command string. The numeric portion of the field number corresponds to the relative position of TEXT, RADIOBOX, and CHECKBOX statements, not to any actual number in these statements.

@1...@n
are optional TEXT statement numbers that can add information to the command before it is submitted. Numbers preceded by an at sign (@) correspond to TEXT statements that use the LEN= option to define input fields.

%1...%n
are optional RADIOBOX statement numbers that can add information to the command before it is submitted. Numbers preceded by a percent sign (%) correspond to RADIOBOX statements following the DIALOG statement.

Note:   Keep in mind that the numbers correspond to RADIOBOX statements, not to RBUTTON statements.  [cautionend]

&1...&n
are optional CHECKBOX statement numbers that can add information to the command before it is submitted. Numbers preceded by an ampersand (&) correspond to CHECKBOX statements following the DIALOG statement.

Note:   To specify a literal @ (at sign), % (percent sign), or & (ampersand) in the command-string, use a double character: @@ (at signs), %% (percent signs), or && (ampersands).  [cautionend]


Details


FOOTNOTE 1:  The actual names of the push buttons vary in different windowing environments. [arrow]


Chapter Contents

Previous

Next

Top of Page

Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.