Changes

Assigns the specified color to the text of a text object with the specified ID number; . Text_SetColor 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 ====<syntaxhighlight>Text_SetColor(ObjectID,TextColor)</syntaxhighlight>

==== 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 [[LegacyColorValue|legacy color value]], or by one of 17 [[:Category:Colors|base color words]].

==== Notes ====* An object-specific ID number is returned by [[Text_New]] when the text object is created.

==== Example ==Examples ==

<syntaxhighlight>Value1=Text_SetColor(3,Blue);</syntaxhighlight>

<syntaxhighlight>Value1=Text_SetColor(3,2138336);</syntaxhighlight>

<syntaxhighlight>[LegacyColorValue=True]; Value1=Text_SetColor(3,4);</syntaxhighlight>