Product Documentation
Virtuoso Space-based Router Command Reference
Product Version IC23.1, September 2023

message_box

message_box 
{ -critical | -info | -warning | -question } 
-msg s_text 
-title s_text 
[ -button1 s_name ] 
[ -button2 s_name ] 
[ -button3 s_name ]

Description

Outputs a user-defined dialog box to the screen, then returns a string to indicate which button was selected in the dialog. This is useful when operating remotely.

Arguments

-button1 s_name

Specifies the label for the leftmost button in the dialog. buttonStr1 can be one of the following: NoButton, Ok, Cancel, Yes, No, Abort, Retry, Ignore, YesAll, or NoAll. The default for this button is OK.

-button2 s_name

Specifies the label for the center button in the dialog. buttonStr2 can be one of the following: NoButton, Ok, Cancel, Yes, No, Abort, Retry, Ignore, YesAll, or NoAll. The default for this button is NoButton, causing this button not to be drawn for this position in the dialog.

-button3 s_name

Specifies the label for the rightmost button in the dialog. buttonStr3 can be one of the following: NoButton,Ok, Cancel, Yes, No, Abort, Retry, Ignore, YesAll, or NoAll. The default for this button is NoButton, causing this button not to be drawn for this position in the dialog.

-critical | -info | -warning | -question

  

Indicates the type of dialog box to output.

-msg s_text

Specifies the message to output in the dialog box.

-title s_text

Specifies the title to use for the dialog box.

Value Returned

s_name

Indicates the label of the button that was selected.

Related Topics

System Commands


Return to top
 ⠀
X