Building Wait Window Messages

When you want to display a wait window message in your application, the first step is to use the VPM Enterprise Message Builder to build the wait window message that you want to display.

To build a wait window message

1.   Message Builder: Select Message Builder on the VPME Tools menu. VPME Displays the Message Builder.

2.   New: Click the New button on the Form Toolbar to create a new blank message record.

3.   Wait Option: Select the Wait option button at the top of the Message Builder.

4.   Message ID: Enter an ID that will uniquely identify your message. You can enter up to 50 characters.

ID Tip 1: We use the beginning characters of the message itself as the message ID for the application messages that VPME provides. The first 50 characters of a message normally will uniquely identify the message. Also, since the message records are displayed in alphabetical order by the message ID, using the beginning characters of messages for the IDs makes it easier to find a specific message.

ID Tip 2: If your message is 50 or fewer characters, you only need to enter the message in the message ID text box. You do not need to reenter the message in the Message edit box. If the Message edit box is left blank, your entry in the ID text box will be displayed as the message.

5.   Message: Enter the message text in the Message edit box.

6.   Message Expression: Instead of entering message text in the Message edit box, you can enter an expression and check the Message Expression check box. When the Message Expression check box is checked, the text displayed in the wait window is determined by evaluating the expression.

7.   Comments: Enter comments about the message in the Comments box.

Comment Tip: We enter the name of the program, form or method that calls the message in the Comments edit box. We suggest you do the same for your messages.

8.   Bell and Wait Options: Click the Bell and Wait Options page on the Message Builder.

9.   Bell: Click the Sound Bell check box if you want the default bell sound when your message is displayed. If you want a custom sound, also click the WAV button and select your .WAV sound file.

10. Nowait: If you want the wait window that displays the message to use the Nowait option, check the Nowait check box.

11. Timeout: If you want the wait window to use the Timeout option, enter the number of seconds that the wait window should be displayed.

12. Save: Click the Save button on the Form Toolbar to save your message.

Tip: After displaying a wait window message, you can clear the message with the following code if the Nowait option is used:

_SCREEN.oApp.oMessage.ClearWait()

More:

Displaying a Message