Справочник по языку программирования MQL5

Подождите немного. Документ загружается.

Графические объекты

841

ObjectsDeleteAll

Удаляет все объекты в указанном графике, указанном подокне указанного графика, указанного

типа.

int ObjectsDeleteAll(

long chart_id, // идентификатор графика

int nwin=-1, // индекс окна

int type=-1 // тип объекта для удаления

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

nwin=-1

[in] Номер подокна графика. 0 означает главное окно графика, -1 означает все подокна

графика, включая главное окно.

type=-1

[in] Тип объекта. Значение может быть одним из значений перечисления ENUM_OBJECT. -1

означает все типы.

Возвращаемое значение

Возвращает количество удаленных объектов. Для получения дополнительной информации об

ошибке необходимо вызвать функцию функцию GetLastError().

Графические объекты

842

ObjectFind

Ищет объект с указанным именем на графике с указанным идентификатором.

int ObjectFind(

long chart_id, // идентификатор графика

string name // имя объекта

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя искомого объекта.

Возвращаемое значение

В случае удачи функция возвращает номер подокна (0 означает главное окно графика), в

котором находится найденный объект. Если объект не найден, то функция возвращает

отрицательное число. Чтобы получить дополнительную информацию об ошибке, необходимо

вызвать функцию GetLastError().

Примечание

При переименовании графического объекта одновременно формируются два события, которые

можно обработать в эксперте или индикаторе функцией OnChartEvent():

событие удаления объекта со старым именем;

событие создания графического объекта с новым именем.

Графические объекты

843

ObjectGetTimeByValue

Возвращает значение времени для указанного значения цены указанного объекта.

datetime ObjectGetTimeByValue(

long chart_id, // идентификатор графика

string name, // имя объекта

double value, // цена

int line_id  // номер линии

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя объекта.

value

[in] Значение цены.

line_id

[in] Идентификатор линии.

Возвращаемое значение

Значение времени для указанного значения цены указанного объекта.

Примечание

Так как объект в одной координате цены может иметь несколько значений, то необходимо

указать номер линии. Эта функция применима только для следующих объектов:

Трендовая линия (OBJ_TREND)

Трендовая линия по углу (OBJ_TRENDBYANGLE)

Линия Ганна (OBJ_GANNLINE)

Равноудаленный канал (OBJ_CHANNEL) - 2 линии

Канал на линейной регрессии (OBJ_REGRESSION) - 3 линии

Канал стандартного отклонения (OBJ_STDDEVCHANNEL) - 3 линии

Линия со стрелкой (OBJ_ARROWED_LINE)

Смотри также

Типы объектов

Графические объекты

844

ObjectGetValueByTime

Возвращает значение цены для указанного времени указанного объекта.

double ObjectGetValueByTime(

long chart_id, // идентификатор графика

string name, // имя объекта

datetime time, // время

int line_id // номер линии

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя объекта.

time

[in] Значение времени.

line_id

[in] Идентификатор линии.

Возвращаемое значение

Значение цены для указанного времени указанного объекта.

Примечание

Так как объект в одной координате цены может иметь несколько значений, то необходимо

указать номер линии. Эта функция применима только для следующих объектов:

Трендовая линия (OBJ_TREND)

Трендовая линия по углу (OBJ_TRENDBYANGLE)

Линия Ганна (OBJ_GANNLINE)

Равноудаленный канал (OBJ_CHANNEL) - 2 линии

Канал на линейной регрессии (OBJ_REGRESSION) - 3 линии

Канал стандартного отклонения (OBJ_STDDEVCHANNEL) - 3 линии

Линия со стрелкой (OBJ_ARROWED_LINE)

Смотри также

Типы объектов

Графические объекты

845

ObjectMove

Изменяет координаты указанной точки привязки объекта.

bool ObjectMove(

long chart_id, // идентификатор графика

string name, // имя объекта

int point_index, // номер привязки

datetime time, // время

double price // цена

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя объекта.

point_index

[in] Номер точки привязки. Количество точек привязки зависит от типа объекта.

time

[in] ВременнАя координата указанной точки привязки.

price

[in] Ценовая координата указанной точки привязки.

Возвращаемое значение

В случае успеха возвращает true, при неудаче возвращает false. Чтобы получить

дополнительную информацию об ошибке, необходимо вызвать функцию GetLastError().

Графические объекты

846

ObjectsTotal

Возвращает количество объектов в указанном чарте, указанном подокне указанного чарта,

указанного типа.

int ObjectsTotal(

long chart_id, // идентификатор графика

int nwin=-1, // индекс окна

int type=-1 // тип объекта

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

nwin=-1

[in] Номер подокна графика. 0 означает главное окно графика, -1 означает все подокна

графика, включая главное окно.

type=-1

[in] Тип объекта. Значение может быть одним из значений перечисления ENUM_OBJECT. -1

означает все типы.

Возвращаемое значение

Количество объектов.

Графические объекты

847

ObjectSetDouble

Задает значение соответствующего свойства объекта. Свойство объекта должно быть типа double.

Существует 2 варианта функции.

Установка значения свойства, не имеющего модификатора

bool ObjectSetDouble(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

double prop_value  // значение

);

Установка значения свойства с указанием модификатора

bool ObjectSetDouble(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

int prop_modifier, // модификатор

double prop_value  // значение

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя объекта.

prop_id

[in] Идентификатор свойства объекта. Значение может быть одним из значений перечисления

ENUM_OBJECT_PROPERTY_DOUBLE.

prop_modifier

[in] Модификатор указанного свойства. Означает номер уровня в инструментах Фибоначчи и в

графическом объекте Вилы Эндрюса. Нумерация уровней начинается с нуля.

prop_value

[in] Значение свойства.

Возвращаемое значение

Возвращает true только в том случае, если команда на изменение свойств графического

объекта успешно отправлена графику, иначе возвращает false. Чтобы получить дополнительную

информацию об ошибке, необходимо вызвать функцию GetLastError().

Пример создания Фибо-объекта и добавления нового уровня в нем

Графические объекты

848

//| Script program start function |

//+------------------------------------------------------------------+

void OnStart()

{

//--- вспомогательные массивы

double high[],low[],price1,price2;

datetime time[],time1,time2;

//--- скопируем цены открытия - 100 последних баров хватит

int copied=CopyHigh(Symbol(),0,0,100,high);

if(copied<=0)

{

Print("Не удалось скопировать значения ценовой серии High");

return;

}

//--- скопируем цены закрытия - 100 последних баров хватит

copied=CopyLow(Symbol(),0,0,100,low);

if(copied<=0)

{

Print("Не удалось скопировать значения ценовой серии Low");

return;

}

//--- скопируем время открытия для 100 последних баров

copied=CopyTime(Symbol(),0,0,100,time);

if(copied<=0)

{

Print("Не удалось скопировать значения ценовой серии Time");

return;

}

//--- организуем доступ к скопированным данным как к таймсериям - задом наперед

ArraySetAsSeries(high,true);

ArraySetAsSeries(low,true);

ArraySetAsSeries(time,true);

//--- координаты первой точки привязки Фибо-объекта

price1=high[70];

time1=time[70];

//--- координаты первой точки привязки Фибо-объекта

price2=low[50];

time2=time[50];

//--- пора создать и сам Фибо-объект

bool created=ObjectCreate(0,"Fibo",OBJ_FIBO,0,time1,price1,time2,price2);

if(created) // если объект создан удачно

{

//--- установим цвет Фибо0уровней

ObjectSetInteger(0,"Fibo",OBJPROP_LEVELCOLOR,Blue);

//--- кстати, а сколько у нас Фибо-уровней ?

int levels=ObjectGetInteger(0,"Fibo",OBJPROP_LEVELS);

Print("Fibo levels before = ",levels);

//---выведем в Журнал=> номер уровня:значения описание_уровня

for(int i=0;i<levels;i++)

{

Print(i,":",ObjectGetDouble(0,"Fibo",OBJPROP_LEVELVALUE,i),

" ",ObjectGetString(0,"Fibo",OBJPROP_LEVELTEXT,i));

}

//--- попробуем увеличить количество уровней на единицу

bool modified=ObjectSetInteger(0,"Fibo",OBJPROP_LEVELS,levels+1);

if(!modified) // не удалось количество уровней изменить

{

Print("Не удалось изменить количество уровней в Фибо, ошибка ",GetLastError());

}

Графические объекты

849

//--- просто сообщим

Print("Fibo levels after = ",ObjectGetInteger(0,"Fibo",OBJPROP_LEVELS));

//--- зададим значение для вновь созданного уровня

bool added=ObjectSetDouble(0,"Fibo",OBJPROP_LEVELVALUE,levels,133);

if(added) // удалось задать значение для уровня

{

Print("Удалось установить еще один уровень Fibo");

//--- также не забыть задать описание уровня

ObjectSetString(0,"Fibo",OBJPROP_LEVELTEXT,levels,"my level");

ChartRedraw(0);

//--- получим актуальное значения количества уровней в Фибо-объекте

levels=ObjectGetInteger(0,"Fibo",OBJPROP_LEVELS);

Print("Fibo levels after adding = ",levels);

//--- еще раз выведем все уровни - просто чтобы убедиться

for(int i=0;i<levels;i++)

{

Print(i,":",ObjectGetDouble(0,"Fibo",OBJPROP_LEVELVALUE,i),

" ",ObjectGetString(0,"Fibo",OBJPROP_LEVELTEXT,i));

}

else // неудача при попытке увеличить количество уровней в Фибо-объекте

{

Print("Не удалось установить ещеь один уровень Fibo. Ошибка ",GetLastError());

}

Смотри также

Типы объектов, Свойства объектов

Графические объекты

850

ObjectSetInteger

Задает значение соответствующего свойства объекта. Свойство объекта должно быть типов

datetime,int,color,boolилиchar. Существует 2 варианта функции.

Установка значения свойства, не имеющего модификатора

bool ObjectSetInteger(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

long prop_value  // значение

);

Установка значения свойства с указанием модификатора

bool ObjectSetInteger(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

int prop_modifier, // модификатор

long prop_value  // значение

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

name

[in] Имя объекта.

prop_id

[in] Идентификатор свойства объекта. Значение может быть одним из значений перечисления

ENUM_OBJECT_PROPERTY_INTEGER.

prop_modifier

[in] Модификатор указанного свойства. Означает номер уровня в инструментах Фибоначчи и в

графическом объекте Вилы Эндрюса. Нумерация уровней начинается с нуля.

prop_value

[in] Значение свойства.

Возвращаемое значение

Возвращает true только в том случае, если команда на изменение свойств графического

объекта успешно отправлена графику, иначе возвращает false. Чтобы получить дополнительную

информацию об ошибке, необходимо вызвать функцию GetLastError().

Смотри также

Типы объектов, Свойства объектов