Difference between revisions of "TL SetEnd"

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 3: Line 3:
 
Of the two end points of a trendline, the point with the later date and time is always considered to be the ending point; if the trendline is vertical, the point with the higher price value is considered to be the ending point.  
 
Of the two end points of a trendline, the point with the later date and time is always considered to be the ending point; if the trendline is vertical, the point with the higher price value is considered to be the ending point.  
 
   
 
   
==== Usage ====
+
== Usage ==
 
<syntaxhighlight>TL_SetEnd (TL_ID, eDate, eTime, ePriceValue)</syntaxhighlight>  
 
<syntaxhighlight>TL_SetEnd (TL_ID, eDate, eTime, ePriceValue)</syntaxhighlight>  
  
==== Parameters ====
+
== Parameters ==
[[TL_ID]] - a numerical expression specifying the trendline ID number  
+
:'''TL_ID''' - a numerical expression specifying the trendline ID number.
  
[[eDate]] - a numerical expression specifying the new ending point date; the date is indicated in the YYYMMdd format, where YYY is the number of years since 1900, MM is the month, and dd is the day of the month  
+
:'''eDate''' - a numerical expression specifying the new ending point date; the date is indicated in the YYYMMdd format, where YYY is the number of years since 1900, MM is the month, and dd is the day of the month.
  
[[eTime]] - a numerical expression specifying the new ending point time; the time is indicated in the 24-hour HHmm format, where 1300 = 1:00 PM  
+
:'''eTime''' - a numerical expression specifying the new ending point time; the time is indicated in the 24-hour HHmm format, where 1300 = 1:00 PM.
  
[[ePriceValue]] - a numerical expression specifying the new ending point price value (vertical position, corresponding to a value on the price scale of a chart)  
+
:'''ePriceValue''' - a numerical expression specifying the new ending point price value (vertical position, corresponding to a value on the price scale of a chart).
 
   
 
   
==== Notes ====
+
== Notes ==
A trendline-specific ID number is returned by [[TL_New]] when the trendline is created.  
+
* A trendline-specific ID number is returned by [[TL_New]] when the trendline is created.
 +
* Use [[TL_SetEnd_s]] to set the end of a trendline with seconds precision.
 +
* Use [[TL_SetBegin]] and [[TL_SetBegin_s]] to set the beginning of a trend line.
 +
* When moving a trend line, change the end point ''before'' changing the begin point.
 
   
 
   
==== Example ====
+
== Example ==
Move the ending point of the trendline with an ID number of 3 to 14:15 PM on January 17th at a  
+
Move the ending point of the trendline with an ID number of 3 to 14:15 PM on January 17th at a price value of 1350:  
price value of 1350:  
 
  
<syntaxhighlight>Value1=TL_SetEnd(3,1080117,1415,1350);</syntaxhighlight>  
+
<syntaxhighlight>Value1 = TL_SetEnd(3, 1080117, 1415, 1350);</syntaxhighlight>  
 
   
 
   
 
[[Category:Trendline Drawing]]
 
[[Category:Trendline Drawing]]

Latest revision as of 15:08, 2 May 2012

Modifies the ending point location of a trendline with the specified ID number; returns a value of 0 if the ending point location was successfully modified, and a value of -2 if the specified trendline ID number is invalid.

Of the two end points of a trendline, the point with the later date and time is always considered to be the ending point; if the trendline is vertical, the point with the higher price value is considered to be the ending point.

Usage

TL_SetEnd (TL_ID, eDate, eTime, ePriceValue)

Parameters

TL_ID - a numerical expression specifying the trendline ID number.
eDate - a numerical expression specifying the new ending point date; the date is indicated in the YYYMMdd format, where YYY is the number of years since 1900, MM is the month, and dd is the day of the month.
eTime - a numerical expression specifying the new ending point time; the time is indicated in the 24-hour HHmm format, where 1300 = 1:00 PM.
ePriceValue - a numerical expression specifying the new ending point price value (vertical position, corresponding to a value on the price scale of a chart).

Notes

  • A trendline-specific ID number is returned by TL_New when the trendline is created.
  • Use TL_SetEnd_s to set the end of a trendline with seconds precision.
  • Use TL_SetBegin and TL_SetBegin_s to set the beginning of a trend line.
  • When moving a trend line, change the end point before changing the begin point.

Example

Move the ending point of the trendline with an ID number of 3 to 14:15 PM on January 17th at a price value of 1350:

Value1 = TL_SetEnd(3, 1080117, 1415, 1350);