Message style attributes

Message style presentation attributes apply to an error or message.

The element type for both ERROR and MESSAGE is Message. To distinguish ERROR from MESSAGE, the ":error" or ":message" pseudo-selectors can be used to specify a different style for the rendereing of each instruction: "Message:error" corresponds to the ERROR instruction, and "Message:message" corresponds to the MESSAGE instruction.

The ERROR and MESSAGE instructions can get a STYLE attribute in the ATTRIBUTES clause, to specify a particular style name:

MESSAGE "No rows have been found." ATTRIBUTES(STYLE="info")

A limited set of common style attributes are supported for error/message display. In addition to the attributes described in the section, you can only define font style attributes for messages.

Like simple form fields, TTY attributes have a higher priority than style attributes. By default, ERROR has the TTY attribute REVERSE, which explains why ERROR messages have a reverse background, even when you use a backgroundColor style attribute. Use the NORMAL attribute in ERROR, to avoid the default REVERSE TTY attribute and define your own background color with a style.

Consider centralizing your ERROR and MESSAGE instruction calls in a function, to simplify global modifications:

FUNCTION my_error(m, s)
   DEFINE m, s STRING
   IF s IS NULL THEN
       ERROR m ATTRIBUTES(NORMAL)
   ELSE
       ERROR m ATTRIBUTES(NORMAL, STYLE=s)
   END IF
END FUNCTION

This table shows the presentation attributes for ERROR and MESSAGE instructions:

Table 1. Presentation attributes for ERROR and MESSAGE instructions
Attribute	GDC	GWC-JS	GMA	GMI
`position` Defines the output type of the status bar message field. Values can be: `"statusbar"` (default): will display the text in the regular statusbar of the window. `"popup"`: will bring a window popup to the front; it should be used with care, since it can annoy the user. `"statustip"`: will add a small "down" arrow button that will show the popup once the user clicks on it. This can be useful to display very long text. `"both"`: will display the text in a popup window and then in the status bar.	Yes	No	No	No
`textFormat` Defines the rendering of the content of the widget. Possible values are: `"plain"` (default): the value assigned to this widget is interpreted as plain text. `"html"`, it is interpreted as HTML (with hyper-links).	Yes	No	No	No