Difference between revisions of "Text GetFirst"
Jump to navigation
Jump to search
(Created page with "Returns a numerical value, indicating an object ID number of the oldest (the first to be added to the current chart) text object of the specified origin; returns a value of -2...") |
m (Reverted edits by 176.8.90.7 (talk) to last revision by JoshM) |
||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | Returns a numerical value, indicating an object ID number of the oldest (the first to be added to the current chart) text object of the specified origin | + | Returns a numerical value, indicating an object ID number of the oldest (the first to be added to the current chart) text object of the specified origin. |
+ | |||
+ | Text_GetFirst returns a value of -2 if the specified object ID number is invalid. | ||
− | + | == Usage == | |
− | <syntaxhighlight>Text_GetFirst (Origin)</syntaxhighlight> | + | <syntaxhighlight>Text_GetFirst(Origin)</syntaxhighlight> |
− | + | == Parameters == | |
− | + | :'''Origin''' - a numerical expression specifying the origin of the text object: | |
− | 1 - added by the current study | + | ::'''1''' - added by the current study, |
− | 2 - added by a study other then the current study, or drawn manually by the user | + | ::'''2''' - added by a study other then the current study, or drawn manually by the user, |
− | 3 - added by any study, or drawn manually by the user | + | ::'''3''' - added by any study, or drawn manually by the user, |
− | 4 - added by the current study, or drawn manually by the user | + | ::'''4''' - added by the current study, or drawn manually by the user, |
− | 5 - added by a study other then the current study | + | ::'''5''' - added by a study other then the current study, |
− | 6 - added by any study | + | ::'''6''' - added by any study, |
− | 7 - added manually by the user | + | ::'''7''' - added manually by the user. |
− | + | == Notes == | |
− | If the oldest (the first added) text object is deleted, the next oldest (the second added) text object becomes the oldest (the first added) text object. | + | * If the oldest (the first added) text object is deleted, the next oldest (the second added) text object becomes the oldest (the first added) text object. |
− | + | * Use [[Text_GetNext]] to get a specific text object on the chart. | |
− | + | ||
+ | == Example == | ||
Assign a value, indicating an object ID number of the oldest text object added to the chart by the current study, to Value1 variable: | Assign a value, indicating an object ID number of the oldest text object added to the chart by the current study, to Value1 variable: | ||
− | <syntaxhighlight>Value1=Text_GetFirst(1);</syntaxhighlight> | + | <syntaxhighlight>Value1 = Text_GetFirst(1);</syntaxhighlight> |
[[Category:Text Drawing]] | [[Category:Text Drawing]] |
Latest revision as of 12:42, 13 February 2012
Returns a numerical value, indicating an object ID number of the oldest (the first to be added to the current chart) text object of the specified origin.
Text_GetFirst returns a value of -2 if the specified object ID number is invalid.
Contents
Usage
Text_GetFirst(Origin)
Parameters
- Origin - a numerical expression specifying the origin of the text object:
- 1 - added by the current study,
- 2 - added by a study other then the current study, or drawn manually by the user,
- 3 - added by any study, or drawn manually by the user,
- 4 - added by the current study, or drawn manually by the user,
- 5 - added by a study other then the current study,
- 6 - added by any study,
- 7 - added manually by the user.
Notes
- If the oldest (the first added) text object is deleted, the next oldest (the second added) text object becomes the oldest (the first added) text object.
- Use Text_GetNext to get a specific text object on the chart.
Example
Assign a value, indicating an object ID number of the oldest text object added to the chart by the current study, to Value1 variable:
Value1 = Text_GetFirst(1);