Error processing SSI file
Error processing SSI file
Home » Development Area » DigiGuide Listings Grabber » API Index » Function: messageBox
Function: messageBox
Integer messageBox( String message, String caption, [ Integer type ] ) |
Summary
Shows a message box with given message string and specified choice of buttons and icon.
Remarks
The optional nType parameter can be a combination of none or one item from each of the following groups: Button Layouts: Specifies the type of buttons and their organisation.
Value | Description |
knMBOK | OK button only |
knMBOKCancel | OK and Cancel buttons |
knMBYesNo | Yes and No buttons |
knMBYesNoCancel | Yes, No and Cancel buttons |
knMBRetryCancel | Retry and Cancel buttons |
knMBAbortRetryIgnore | Abort, Retry and Ignore buttons |
knMBCancelTryContinue | Cancel, Try and Continue buttons |
Icon: Displays an image in the left side of the message box.
Value | Description |
knMBIconExclamation | Displays an exclamation mark or warning symbol |
knMBIconInformation | Displays an 'i' information icon |
knMBIconQuestion | Displays a question mark |
knMBIconStop | Displays a red 'hand' stop sign |
Default Button: The default button will be highlighted with a bolder border and is activated when the Return key is pressed.
Value | Description |
knMBDefault1 | Specifies that the first button in the group is enabled as default |
knMBDefault2 | Specifies that the second button in the group is enabled as default |
knMBDefault3 | Specifies that the third button in the group is enabled as default |
knMBDefault4 | Specifies that the fourth button in the group is enabled as default |
Parameters
Parameter | Description |
String message |
Specifies the message that will be displayed in the message box. This can contain "\n" characters for a new line. |
String caption |
Specifies the message box caption title. |
Integer type [optional] |
Optional value comprising an OR of a value from each of the available groups. |
|
|
|
Returns
Returns a constant specifying the button that was clicked:
Value |
knMBReturnYes |
knMBReturnNo |
knMBReturnOK |
knMBReturnCancel |
knMBReturnAbort |
knMBReturnContinue |
knMBReturnIgnore |
knMBReturnRetry |
knMBReturnTryAgain |
Examples
if( messageBox( "This is a simple box.\n\nClick Yes or No.", "Caption", knMBYesNo | knMBIconQuestion | knMBDefault2 ) == knMBReturnYes ) { debugOut( "Button Yes was clicked" ); }
|
See Also
alert
debugOut
Requirements
Build Build 3
(Last updated: February 13, 2020 12:43:31)
Error processing SSI file