Text SetColor

Assigns the specified color to the text of a text object with the specified ID number; returns a value of 0 if the color was successfully assigned, and a value of -2 if the specified object ID number is invalid.

Usage

Text_SetColor(ObjectID,TextColor)

Parameters

ObjectID - a numerical expression specifying the object ID number

TextColor - an expression specifying the text color

The color can be specified by a numerical expression representing an RGB color number or a legacy color value, or by one of 17 base color words.

Notes

An object-specific ID number is returned by Text_New when the text object is created.

Example

Assign the color blue to the text of a text object with the ID number of 3:

Value1=Text_SetColor(3,Blue);

Assign the RGB color 2138336 (Orange) to the text of a text object with the ID number of 3:

Value1=Text_SetColor(3,2138336);

Assign the legacy color 4 (Green) to the text of a text object with the ID number of 3:

[LegacyColorValue=True];
Value1=Text_SetColor(3,4);