9.143 MESSAGE_BOX_ADD
Note: Built-In Function Rules Usage Options
Adds one or more items to the message box assembly area as a new message line. These items would normally be displayed by the MESSAGE_BOX_SHOW, Built-In Function at some later time.
Arguments
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
X
|
Req
|
First item to be added to the message box assembly area
|
1
|
256
|
0
|
9
|
|
2 -10
|
X
|
Opt
|
Subsequent items to be added to the message box assembly area
|
1
|
256
|
0
|
9
|
|
Return Values
There are no Return Values
Technical Notes
- The first item in the list of items specified causes a new message line to be started.
- Subsequent items in the list are separated by a single blank from the preceding item.
- Items are converted to left aligned strings and trailing blanks are truncated. A completely blank/null item is converted to a single blank.
- The maximum length of 256 characters is true if the argument is specified as a character variable. However, the maximum length of a character literal is 48 characters.
- Messages from successive MESSAGE_BOX_ADD commands are added to the message box assembly area. The message box message assembly area can contain at most 4096 characters (including automatically inserted blanks or control characters). Once the assembly area reaches its maximum size all in progress or subsequent add or append operations are ignored. No notification or error is given when this situation arises.
- The message assembly area is cleared at completion of a MESSAGE_BOX_SHOW command.
Examples
Refer to 9.146 MESSAGE_BOX_SHOW.
