Changes
Created page with "Assigns the specified background color to 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 spe..."
Assigns the specified background color to 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 ====
<syntaxhighlight>Text_SetBGColor(ObjectID,BGColor)</syntaxhighlight>
==== Parameters ====
[[ObjectID]] - a numerical expression specifying the object ID number
[[BGColor]] - an expression specifying the background 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 background of a text object with the ID number of 3:
<syntaxhighlight>Value1=Text_SetBGColor(3,Blue);</syntaxhighlight>
Assign the RGB color 2138336 (Orange) to the background of a text object with the ID number of 3:
<syntaxhighlight>Value1=Text_SetBGColor(3,2138336);</syntaxhighlight>
Assign the legacy color 4 (Green) to the background of a text object with the ID number of 3:
<syntaxhighlight>[LegacyColorValue=True];
Value1=Text_SetBGColor(3,4);</syntaxhighlight>
[[Category:Text Drawing]]
==== Usage ====
<syntaxhighlight>Text_SetBGColor(ObjectID,BGColor)</syntaxhighlight>
==== Parameters ====
[[ObjectID]] - a numerical expression specifying the object ID number
[[BGColor]] - an expression specifying the background 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 background of a text object with the ID number of 3:
<syntaxhighlight>Value1=Text_SetBGColor(3,Blue);</syntaxhighlight>
Assign the RGB color 2138336 (Orange) to the background of a text object with the ID number of 3:
<syntaxhighlight>Value1=Text_SetBGColor(3,2138336);</syntaxhighlight>
Assign the legacy color 4 (Green) to the background of a text object with the ID number of 3:
<syntaxhighlight>[LegacyColorValue=True];
Value1=Text_SetBGColor(3,4);</syntaxhighlight>
[[Category:Text Drawing]]