Difference between revisions of "Arw SetTextBGColor"
Jump to navigation
Jump to search
(Created page with "Assigns the specified background color to the text of an arrow object with the specified ID number; returns a value of 0 if the color was successfully assigned, and a value of...") |
|||
(3 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
− | Assigns the specified background color to the text of an arrow object with the specified ID number | + | Assigns the specified background color to the text of an arrow object with the specified ID number. |
+ | |||
+ | Arw_SetTextBGColor 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>Arw_SetTextBGColor(ObjectID,TextBGColor)</syntaxhighlight> | + | <syntaxhighlight>Arw_SetTextBGColor(ObjectID, TextBGColor)</syntaxhighlight> |
− | + | == Parameters == | |
− | + | :'''ObjectID''' - a numerical expression specifying the object ID number. | |
− | + | :'''TextBGColor''' - an expression specifying the text 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 [[:Category:Colors|17 base color words]]. |
− | + | == Notes == | |
− | An object-specific ID number is | + | * An object-specific ID number is assigned by [[Arw_New]], [[Arw_New_s]], [[Arw_New_self]] or [[Arw_New_self_s]] when the arrow object is created. |
+ | * Use [[Arw_GetActive]], [[Arw_GetFirst]] or [[Arw_GetNext]] to get the object-specific ID number of an already created arrow. | ||
− | == | + | == Examples == |
− | Assign the color blue to the text background of an arrow object with the ID number of 3: | + | Assign the color [[Blue|blue]] to the text background of an arrow object with the ID number of 3: |
+ | |||
+ | <syntaxhighlight>Value1 = Arw_SetTextBGColor(3, Blue);</syntaxhighlight> | ||
− | + | Assign the [[RGB]] color 2138336 (Orange) to the text background of an arrow object with the ID number of 3: | |
− | + | <syntaxhighlight>Value1 = Arw_SetTextBGColor(3, 2138336);</syntaxhighlight> | |
− | + | Assign the [[LegacyColorValue|legacy color]] 4 ([[Green]]) to the text background of an arrow object with the ID number of 3: | |
− | + | <syntaxhighlight>[LegacyColorValue = True]; | |
− | + | Value1 = Arw_SetTextBGColor(3, 4);</syntaxhighlight> | |
− | Value1=Arw_SetTextBGColor(3,4);</syntaxhighlight> | ||
[[Category:ArrowDrawing]] | [[Category:ArrowDrawing]] |
Latest revision as of 09:20, 19 February 2012
Assigns the specified background color to the text of an arrow object with the specified ID number.
Arw_SetTextBGColor 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
Arw_SetTextBGColor(ObjectID, TextBGColor)
Parameters
- ObjectID - a numerical expression specifying the object ID number.
- TextBGColor - an expression specifying the text 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 assigned by Arw_New, Arw_New_s, Arw_New_self or Arw_New_self_s when the arrow object is created.
- Use Arw_GetActive, Arw_GetFirst or Arw_GetNext to get the object-specific ID number of an already created arrow.
Examples
Assign the color blue to the text background of an arrow object with the ID number of 3:
Value1 = Arw_SetTextBGColor(3, Blue);
Assign the RGB color 2138336 (Orange) to the text background of an arrow object with the ID number of 3:
Value1 = Arw_SetTextBGColor(3, 2138336);
Assign the legacy color 4 (Green) to the text background of an arrow object with the ID number of 3:
[LegacyColorValue = True];
Value1 = Arw_SetTextBGColor(3, 4);