MQL4 Reference Object Functions ObjectGetShiftByValue

ObjectGetShiftByValue

The function calculates and returns bar index (shift related to the current bar) for the given price.

int  ObjectGetShiftByValue(
   string   object_name,   // object name
   double   value          // price
   );

Parameters

object_name

[in]  Object name.

value

[in]  Price value.

Returned value

The function calculates and returns bar index (shift related to the current bar) for the given price. The bar index is calculated by the first and second coordinates using a linear equation. Applied to trendlines and similar objects. To get the detailed error information, one has to call the GetLastError() function.

Note

When this function is used on the current chart, this chart is accessed directly, while in order to receive the properties of an object on a different chart, a synchronous call is used. The synchronous call means that the function waits for the execution of all commands that have been enqueued for this chart prior to its call, that is why this function can be time consuming. This feature should be taken into account when working with a large number of objects on a chart.

Example:

  int shift=ObjectGetShiftByValue("MyTrendLine#123", 1.34);

See also

ObjectGetValueByShift()