Difference between revisions of "Arw SetTextColor"

From MultiCharts
Jump to navigation Jump to search
m (Reverted edits by 176.8.90.7 (talk) to last revision by 194.84.116.138)
 
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 ==
[[ObjectID]] - a numerical expression specifying the object ID number  
+
:'''ObjectID''' - a numerical expression specifying the object ID number.
  
[[TextColor]]- 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 [[Arw_New]] 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);