Difference between revisions of "Text SetString"

From MultiCharts
Jump to navigation Jump to search
(Created page with "Replaces with the specified string expression the text contained in a text object with the specified ID number; returns a value of 0 if the string expression was successfully ...")
 
Line 1: Line 1:
Replaces with the specified string expression the text contained in a text object with the specified ID number; returns a value of 0 if the string expression was successfully replaced, and a value of -2 if the specified object ID number is invalid.  
+
Replaces with the specified string expression the text contained in a text object with the specified ID number.
 +
 
 +
Text_SetString returns a value of 0 if the string expression was successfully replaced and a value of -2 if the specified object ID number is invalid.  
 
   
 
   
==== Usage ====
+
== Usage ==
<syntaxhighlight>Text_SetString(ObjectID,"Text")</syntaxhighlight>  
+
<syntaxhighlight>Text_SetString(ObjectID, "Text")</syntaxhighlight>  
 +
 
 +
Where:
  
Where: [[ObjectID]] - a numerical expression specifying the object ID number  
+
:'''ObjectID''' - a numerical expression specifying the object ID number.
 
              
 
              
[[Text]] - the new string expression to be displayed in the text object  
+
:'''Text''' - the new string expression to be displayed in the text object.
 
   
 
   
==== Notes ====  
+
== 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 ====
+
== Example ==
 
Replace the text, contained in a text object with the ID number of 3, with the string expression "New Text":  
 
Replace the text, contained in a text object with the ID number of 3, with the string expression "New Text":  
  
<syntaxhighlight>Value1=Text_SetString(3,"New Text");</syntaxhighlight>  
+
<syntaxhighlight>Value1 = Text_SetString(3, "New Text");</syntaxhighlight>  
 
   
 
   
 
[[Category:Text Drawing]]
 
[[Category:Text Drawing]]

Revision as of 08:36, 9 February 2012

Replaces with the specified string expression the text contained in a text object with the specified ID number.

Text_SetString returns a value of 0 if the string expression was successfully replaced and a value of -2 if the specified object ID number is invalid.

Usage

Text_SetString(ObjectID, "Text")

Where:

ObjectID - a numerical expression specifying the object ID number.
Text - the new string expression to be displayed in the text object.

Notes

An object-specific ID number is returned by Text_New when the text object is created.

Example

Replace the text, contained in a text object with the ID number of 3, with the string expression "New Text":

Value1 = Text_SetString(3, "New Text");