MessageBox function presents the user with a message box and stops processing of the test.
| Syntax: | 
|---|
| returnValue = MessageBox( message, [Button Options], [Icon and Sound] ) | 
| Parameter: | Description: | 
|---|---|
| message | The string message to display. | 
| [Button Options] | Optional: The decimal number from the type1 list. | 
| [Icon and Sound] | Optional: Then decimal number from the type2 list. | 
| returnValue | Decimal number from the return value list. | 
| Button Options: | Icon and Sound Options: | Button Return Values: | 
|---|---|---|
| 0 -- OK 1 -- OK/Cancel 2 -- Abort/Retry/Ignore 3 -- Yes/No/Cancel 4 -- Yes/No 5 -- Retry/Cancel 6 -- Cancel/Try Again/Continue | 16 -- Icon X, Critical Stop Sound 32 -- Icon Question, Ding Sound 48 -- Icon Exclamation, Exclamation Sound 64 -- Icon Information, Error Sound 80 -- No Icon, Ding Sound 128 -- No Icon, No Sound | 1 -- OK 2 -- Cancel 3 -- Abort 4 -- Retry 5 -- Ignore 6 -- Yes 7 -- No 10 -- Try Again 11 -- Continue | 
| Example: | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| '  Create Message Box Parameter Details:   | ||||||||||
| Returns Any of these Dialog Examples: | ||||||||||
| 
 
 | ||||||||||
| Example 2: | ||||||||||
| '  Ask User if it is OK to continue Processing Data 
 | ||||||||||
| Example 3: | ||||||||||
| '  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~   ' 1 -- OK ' 2 -- Cancel ' 3 -- Abort ' 4 -- Retry ' 5 -- Ignore ' 6 -- Yes ' 7 -- No ' 10 -- Try Again ' 11 -- Continue ' BPV String Series - Manual Index ReturnMeaning[1] = "1 -- OK" 
 ' ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ '  Create Message Box Parameter Details: ' ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
 | ||||||||||
| Button Returns: | ||||||||||
| Message Box Returned: 1 -- OK Message Box Returned: 2 -- Cancel Message Box Returned: 4 -- Retry Message Box Returned: 4 -- Retry Message Box Returned: 7 -- No Message Box Returned: 6 -- Yes Message Box Returned: 2 -- Cancel Message Box Returned: 10 -- Try Again | 
| Links: | 
|---|
| See Also: | 
| Edit Time: 9/20/2020 11:46:40 AM | Topic ID#: 419 |