Common Desktop Environment: Application Builder User's Guide

To Create a Message Dialog Box

See "Message Editor" for descriptions of each of the fields in the editor. See "To Connect a Non-Modal Message to a Function" for a discussion of how to connect messages to the functions that cause them to be displayed, with examples.

  1. Choose Messages from the Editors menu of the App Builder primary window to display the Message Editor.

  2. Choose the module to which you want to add a message in the option menu below the Messages list.

  3. Click Add Message.

    A unique name ("message," "message2," and so on, depending on how many messages are in the current module) will be displayed in the Name field. The module name and the message name will be added to the Messages list.

  4. Modify the Name if you wish.

    This is the name used to identify the message internally--in the Connections Editor, for instance. This name is not displayed in the compiled message dialog box.

  5. Type a title for the message dialog in the Dialog Title field.

    This will appear in the title bar of the compiled message dialog box.

  6. Choose a message type from the Type menu.

    The icon for the message type will be displayed in the Type menu and the message type (Error, Information, Working, Question, or Warning) will be displayed above the message text pane (to the right of the Type menu).

  7. Type the message text in the message text pane, pressing Return when you want a new line to start in the compiled message.

  8. Specify which buttons will appear in the message dialog box by clicking the check boxes below the message text pane and typing the labels you want on the Action1, Action2, and Action3 buttons.

    Each of the message types includes a default set of buttons that you can modify:

    • Error: Action2 (Retry), Cancel, Help.

    • Information: Action1 (OK), Help.

    • Working: Action1 (Close), Action2 (Stop), Help.

    • Question: Action1 (Yes), Action2 (No), Help.

    • Warning: Action2 (Continue), Cancel, Help.

  9. Choose a default button from the Default Button menu.

    This is the button that will have an extra border when the message dialog box is displayed. This is the button that will be activated if Return is pressed. Each of the message types has a default Default Button that you can modify:

    • Error: Action2

    • Information: Action1

    • Working: Action1

    • Question: Action1

    • Warning: Action2

  10. Click the Help Text button and create help text, as appropriate.

    See "To Create Help" for instructions.

  11. Click OK or Apply to apply the changes.

    The Message Editor will be dismissed if you click OK.