Command: ifyes

Syntax

ifyes <message>
    <command_block>

Description

Prompt the operator for a yes/no answer via a dynamic menu.

Parameters

• <message>
  The prompt in the form of an output list.

• <command_block>
  One command or a block of commands to be executed if a Yes answer was given.

Switches

• -col=<color>
  The color of the pop-up window. If omitted, a default color is used.

• -fo=<font>
  The font to be used for text in the pop-up window. This must be a fixed font. If omitted, a default system font is used.

• -m{p}
  Permit the operator to choose from the master menus as an alternative to answering the prompt.

• If -mp is used, all commands selected from master menus will be executed in-line, i.e. control will return to the pop-up menu after execution.

• If -m is used then only master menu commands beginning with a | character will be executed in-line, and commands without a leading | will abort the pop-up before being executed.

• -n
  If no answer is given, assume a No answer.

• -ocol=<color>
  The other color for use in the pop-up window, e.g. for text. If omitted, a default color is used.

• -pos=<screen_xy>
  The position of the pop-up prompt in screen coordinates. If omitted, the value of the system numeric menu_position is used.

• -t - Give the prompt in the monitor terminal window rather than in a pop-up form (the default behavior).

• -tit=<string>
  The text to be displayed in the menu window frame. If omitted, the program name is displayed.

• -y
  If no answer is given, assume a Yes answer.

Notes

A question mark ( ? ) will be automatically added to the prompt.

The command or command block on the line following the ifyes command will be executed if a Yes answer was given by the operator. This may be followed by an else statement which will be executed if a No answer was given.

When used in conjunction with master menus (-m), the selection of a master menu command resulting in an abort of the pop-up will skip execution of the <command_block> associated with this command and any accompanying else statement.

Examples

Single command execution on answering Yes. Note the semicolon to indicate a new line.

ifyes 'OK so far'; return

Command block execution.

ifyes 'Do you wish to exit', -n {
    exec tidyup
    return
}
else !Continuing

See Also