webmessage

Displays a message in a dialog box in the browser.

webmessage/info | /warning | /error  Message  {,  PropertyList}

Example: webmessage/info vMessage, vPropList

Qualifiers

Qualifiers
Qualifier Description
/info/warning/error Specify the message severity; the dialog box displays a matching icon.

Parameters

Parameters
Parameter Data Type Description
Message String Message to be displayed. The interpretation of the message depends on the switch.
PropertyList String Associative list of one or more of the following property names, controlling the size and content of the dialog.
  • xsize—horizontal size in pixels; value must be from 100 through 800.
  • ysize—vertical size in pixels; value must be from 100 through 500.
  • buttontext—text on the confirmation button; default is OK is used. Text is truncated at 128 characters.
  • title—text of the title bar. When not defined, Uniface is used. Text is truncated at 128 characters.

Return Values

None

Use

Use in Dynamic Server Page components.

Description

webmessage produces an asynchronous message box and does not stop JavaScript execution. Calling this function three times in a row causes three message boxes to appear in the browser.

The dimensions of the message box can be controlled by xsize and ysize in the PropertyList. If they are not defined, the message box is sized to fit the data, with the minimum dimension of approximately 400 pixels. If the text is too long to fit, the message box wraps the text and displays a scroll bar.

Note:  For predictable behavior, it is recommended that you define at least the xsize of the message box.

The appearance of the message dialog is determined the uwindow.css stylesheet. You can change the look and feel of the dialog by editing this file.

The message severity, as indicated by the switch used, is indicated by the following icons.

Icon Severity

Info icon

Info

Warning icon

Warning

Error icon

Error
History

Version

Change

9.4.01

Introduced