Difference between revisions of "Arw SetTextColor"

From MultiCharts
Jump to navigation Jump to search
(Created page with "Assigns the specified color to the text contained in an arrow object with the specified ID number; returns a value of 0 if the color was successfully assigned, and a value of ...")
 
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Assigns the specified color to the text contained in an arrow 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.  
+
Assigns the specified color to the text contained in an arrow object with the specified ID number.
 +
 
 +
Arw_SetTextColor 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 ====
+
== Usage ==
<syntaxhighlight>Arw_SetTextColor(ObjectID,TextColor)</syntaxhighlight>  
+
<syntaxhighlight>Arw_SetTextColor(ObjectID, TextColor)</syntaxhighlight>  
  
==== Parameters ====  
+
== Parameters ==
<syntaxhighlight>ObjectID</syntaxhighlight> - a numerical expression specifying the object ID number  
+
:'''ObjectID''' - a numerical expression specifying the object ID number.
  
<syntaxhighlight>TextColor</syntaxhighlight> - an expression specifying the color of the text  
+
:'''TextColor''' - an expression specifying the color of the text.
  
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 ====  
+
== Notes ==
An object-specific ID number is returned by <syntaxhighlight>Arw_New</syntaxhighlight> when the arrow object is created.  
+
* 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.
 
   
 
   
==== Example ====
+
== Examples ==
Assign the color blue to the text contained in an arrow object with the ID number of 3:  
+
Assign the color [[Blue|blue]] to the text contained in an arrow object with the ID number of 3:  
 +
 
 +
<syntaxhighlight>Value1 = Arw_SetTextColor(3, Blue);</syntaxhighlight>
  
<syntaxhighlight>Value1=Arw_SetTextColor(3,Blue);</syntaxhighlight>
+
Assign the [[RGB]] color 2138336 (Orange) to the text contained in an arrow object with the ID number of 3:
  
Assign the RGB color 2138336 (Orange) to the text contained in an arrow object with the ID number of 3:
+
<syntaxhighlight>Value1 = Arw_SetTextColor(3, 2138336);</syntaxhighlight>
  
<syntaxhighlight>Value1=Arw_SetTextColor(3,2138336);</syntaxhighlight>
+
Assign the [[LegacyColorValue|legacy color]] 4 ([[Green]]) to the text contained in an arrow object with the ID number of 3:
  
Assign the legacy color 4 (Green) to the text contained in an arrow object with the ID number of 3:
+
<syntaxhighlight>[LegacyColorValue = True];
  
<syntaxhighlight>[LegacyColorValue=True];
+
Value1 = Arw_SetTextColor(3, 4);</syntaxhighlight>
Value1=Arw_SetTextColor(3,4);</syntaxhighlight>
 
  
 
[[Category:ArrowDrawing]]
 
[[Category:ArrowDrawing]]

Latest revision as of 09:18, 19 February 2012

Assigns the specified color to the text contained in an arrow object with the specified ID number.

Arw_SetTextColor 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

Arw_SetTextColor(ObjectID, TextColor)

Parameters

ObjectID - a numerical expression specifying the object ID number.
TextColor - an expression specifying the color of the text.
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

Examples

Assign the color blue to the text contained in an arrow object with the ID number of 3:

Value1 = Arw_SetTextColor(3, Blue);

Assign the RGB color 2138336 (Orange) to the text contained in an arrow object with the ID number of 3:

Value1 = Arw_SetTextColor(3, 2138336);

Assign the legacy color 4 (Green) to the text contained in an arrow object with the ID number of 3:

[LegacyColorValue = True];

Value1 = Arw_SetTextColor(3, 4);