BACKGROUND Mnemonic - Set Control Background Color (SYSGUI)

BBj-Specific Information

Syntax

'BACKGROUND'(id,colornum)
'BACKGROUND'(id,"colorname")
'BACKGROUND'(id,red_val,green_val,blue_val)

Description

The 'BACKGROUND' mnemonic sets the background color of controls.

Parameter

Description

colornum

Color number from the table below.

"colorname"

Name of the color from the table below.

red_val,green_val,blue_val

RGB value.

id

The control id of the control.

colornum

colorname

0

BLACK

1

BLUE

2

RED

3

MAGENTA

4

GREEN

5

CYAN

6

YELLOW

7

WHITE

8

DKGRAY

9

GRAY

10

LTGRAY

An !ERROR=29 is returned if the colornum or RGB parameters are out of range or the entry in colornum does not evaluate to one of the specified strings.

Background and foreground colors on windows can only be changed before any image or object is drawn on the window. Once a drawing mnemonic or image is used on the window, the background and foreground mnemonics, when called on a window, will be ignored. The mnemonics will always work on other control types. For more information, see SYSGUI Drawing - Introduction.

See Also

Mnemonics - Alphabetical Listing

Mnemonics - Group Listing