TL SetEnd

From MultiCharts
Jump to: navigation, search

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);