UI_MSG_BOX()

Syntax

Response_Code as N = UI_MSG_BOX( Title_Text as C, Message_Text as C [, Message_Type as N ] )

Argument

Description

Title_Text

The title of the dialog box.

Message_Text

The message to display.

Message_Type

You form this message box variation by adding the values as youneed from as many of the following groups in the format: value1 + value2 + value3.

Value1	Button Combination	Description
	UI_OK	OK button (default)
	UI_OK_CANCEL	OK and Cancel buttons
	UI_ABORT_RETRY_IGNORE	Abort, Retry, and Ignore buttons
	UI_YES_NO_CANCEL	Yes, No, and Cancel buttons
	UI_YES_NO	Yes and No buttons
	UI_RETRY_CANCEL	Retry and Cancel buttons
Value2	Symbol Type	Description	Icon
	UI_NO_SYMBOL	No symbol (default)
	UI_STOP_SYMBOL	Stop symbol
	UI_QUESTION_SYMBOL	Question symbol
	UI_ATTENTION_SYMBOL	Attention symbol
	UI_INFORMATION_SYMBOL	Information symbol
Value3	Default Button	Description
	UI_FIRST_BUTTON_DEFAULT	First button is the default
	UI_SECOND_BUTTON_DEFAULT	Second button is the default
	UI_THIRD_BUTTON_DEFAULT	Third button is the default

Description

UI_MSG_BOX() displays several variations of the standard Windows message dialog box. The dialog box variation is determined by the value of the optional Message Type parameter. If you omit the Message_Type, a default message box with a single OK button appears. [Picture] [Picture]

The UI_MSG_BOX() function returns one of the following Response Codes:

Response Code	Description
UI_OK_SELECTED	OK selected
UI_CANCEL_SELECTED	Cancel selected
UI_ABORT_SELECTED	Abort selected
UI_RETRY_SELECTED	Retry selected
UI_IGNORE_SELECTED	Ignore selected
UI_YES_SELECTED	Yes selected
UI_NO_SELECTED	No selected

Supported By

Alpha Five Version 5 and Above

Limitations

Desktop applications only.

Example

Display a Yes, No, Cancel dialog box with a question mark icon and No selected as the default.

'Compute the code for the Message Type

code = UI_YES_NO_CANCEL + UI_QUESTION_SYMBOL + UI_SECOND_BUTTON_DEFAULT

response = ui_msg_box("Question", "Save before leaving? ", code)

if response = UI_YES_SELECTED then

'Yes selected

'------------

elseif response = UI_NO_SELECTED then

'No selected

'-----------

elseif response = UI_CANCEL_SELECTED then

'Cancel selected

'---------------

end if