Difference between revisions of "Text SetBGColor"
Jump to navigation
Jump to search
(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...") |
|||
Line 1: | Line 1: | ||
− | Assigns the specified background color to a text object with the specified ID number | + | Assigns the specified background color to a text object with the specified ID number. |
+ | |||
+ | Text_SetBGColor 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> | + | <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. | + | ::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. | + | * 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: | Assign the color blue to the background of a text object with the ID number of 3: | ||
− | <syntaxhighlight>Value1=Text_SetBGColor(3,Blue);</syntaxhighlight> | + | <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: | 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> | + | <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: | Assign the legacy color 4 (Green) to the background of a text object with the ID number of 3: | ||
− | <syntaxhighlight>[LegacyColorValue=True]; | + | <syntaxhighlight>[LegacyColorValue = True]; |
− | Value1=Text_SetBGColor(3,4);</syntaxhighlight> | + | |
+ | Value1 = Text_SetBGColor(3, 4);</syntaxhighlight> | ||
[[Category:Text Drawing]] | [[Category:Text Drawing]] |
Revision as of 08:48, 9 February 2012
Assigns the specified background color to a text object with the specified ID number.
Text_SetBGColor returns a value of 0 if the color was successfully assigned and a value of -2 if the specified object ID number is invalid.
Contents
Usage
Text_SetBGColor(ObjectID, BGColor)
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:
Value1 = Text_SetBGColor(3, Blue);
Assign the RGB color 2138336 (Orange) to the background of a text object with the ID number of 3:
Value1 = Text_SetBGColor(3, 2138336);
Assign the legacy color 4 (Green) to the background of a text object with the ID number of 3:
[LegacyColorValue = True];
Value1 = Text_SetBGColor(3, 4);