Table of Contents

theField.backgroundColor

Description

The integer backgroundColor property sets the color of a text field's background. Colors are specified as a single number, most commonly a six-digit hexadecimal value of the form 0xRRGGBB, where RR, GG, and BB are two-digit numbers between 00 and FF, representing the Red, Green, and Blue components. For example, the RGB triplet (R: 51, G: 51, B: 102) is equivalent to the hexadecimal value:

0x333366

The default value is white (0xFFFFFF). For more information on RGB triplet notation, see the Color class.

The backgroundColor property has a visible effect only when the background property is true; when background is false, no background is shown, even if backgroundColor is set. For example, the following code tries to set the background color of theField_txt to blue, but the color does not appear because background is not yet set:

this.createTextField("theField_txt", 1, 0, 0, 200, 20);
theField_txt.text = "this text has a blue background";
theField_txt.backgroundColor = 0x0000FF;

To make the blue background appear, we must add the following line:

theField_txt.background = true;

Setting the value of background does not alter the value of backgroundColor.

See Also

TextField.background, TextField.border, TextField.borderColor, the Color class

Table of Contents