BACKGROUND-COLOUR-VALUE

Provides a facility to define customized background colors.

When setting background colors, you have four possibilities:

  • Define your own color by using the BACKGROUND-COLOUR-VALUE attribute in a dialog editor Attributes window. To do so, you must first set the BACKGROUND-COLOUR-NAME attribute to CUSTOM (50). A dialog box appears where you can set values for the red, green, and blue elements of your color (RGB model).

  • Use the BACKGROUND-COLOUR-NAME attribute and leave the value at DEFAULT (0). Your color will then be determined by your color settings in the operating system.

  • Use the BACKGROUND-COLOUR-NAME attribute and choose from one of the dialog editor's predefined colors. These are represented by the values 1 to 18.

  • Set the color dynamically in event handler code by assigning a set of three RGB values to the attribute. To do so, you must first set the BACKGROUND-COLOUR-NAME attribute to CUSTOM (50). You enter the three RGB values in hexadecimal form, such as "H'FF0000'.

Note:
Due to consistency constraints imposed by Windows, the specified setting may not be effective for particular dialog element types, depending on the version of Windows in use and whether visual themes are enabled.

Applies to Canvas control, control box control, dialog (all types), date/time picker control, dialog bar control, edit area control, group frame control, image control, input field control, list box control, list view control, OLE container control, progress bar control, push button control, radio button control, rectangle control, scroll bar control, selection box control, signal, tab control, table control, text constant control, toggle button control, tree view control, wallpaper control.
Data Type B3
Default Value None
Possible Values Any red, green, and blue value from 1 to 253