Ковалев Сергей. Программирование на алгоритмическом языке MQL4

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

791

datetime time2=0, double price2=0, datetime time3=0, double

price3=0)

Функция создаёт объект указанного типа с заданным именем и начальными координатами

в указанном подокне графика. Число координат, связываемых с объектом, может быть от

1 до 3 в зависимости от его типа. При успешном создании объекта функция возвращает

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

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

Координаты должны передаваться парами - время и цена. Например, объекту OBJ_VLINE

требуется только время, но также нужно передать и цену (любое значение). Графический

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

свойств OBJPROP_XDISTANCE и OBJPROP_YDISTANCE этого объекта необходимо

использовать функцию ObjectSet().

Параметры:

name - имя объекта;

type - тип объекта (может быть одним из предопределённых типов объектов);

window - номер окна, в которое будет добавлен объект. Нумерация подокон графика (если

на графике есть подокна с индикаторами) начинается с 1, главное окно графика есть

всегда и имеет номер 0; указываемый номер окна должен быть большим или равным 0 и

меньшим, чем значение, возвращаемое функцией WindowsTotal();

time1 - время первой координаты;

price1 - цена первой координаты;

time2 - время второй координаты;

price2 - цена второй координаты;

time3 - время третьей координаты;

price3 - цена третьей координаты.

Каждый графический объект имеет некоторые (свойственные ему) настраиваемые

параметры. Например, кроме задаваемых координат объекту можно установить цвет,

текст сообщения (для одних объектов), стиль линий (для других объектов) и т.д. Для

изменения свойств объектов используется функция:

792

12.2.6 Функция ObjectSet()

bool ObjectSet(string name, int prop_id, double value)

Функция изменяет значение указанного свойства объекта. В случае успеха функция

возвращает TRUE, иначе FALSE. Для получения информации об ошибке необходимо

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

Параметры:

name - имя объекта;

prop_id - идентификатор свойства объекта (указывается одно из свойств объекта);

value - новое значение указанного свойства.

Все графические объекты могут иметь также текстовое описание. Текстовое описание

каждого объекта доступно пользователю и может быть изменено на панели свойств

объекта или программным способом. Для объектов OBJ_TEXT и OBJ_LABEL это

описание составляет их основное содержание и всегда отображается в виде текстовой

строки. Текстовые описания других объектов отображаются в непосредственной близости

от изображения самого объекта в том случае, если включена опция "Показывать описания

объектов" на панели свойств окна финансового инструмента (F8). Для изменения

текстового описания объекта используется функция:

12.2.7 Функция ObjectSetText()

bool ObjectSetText(string name, string text, int font_size,

string font_name=NULL, color text_color=CLR_NONE)

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

TRUE, иначе FALSE. Для получения дополнительной информации об ошибке необходимо

вызвать функцию функцию GetLastError().Параметры font_size, font_name и text_color

используются только для объектов OBJ_TEXT и OBJ_LABEL. Для объектов других типов

эти параметры игнорируются.

Параметры:

name - имя объекта;

text - текст описания обьекта;

793

font_size - размер шрифта в пунктах;

font_name - наименование шрифта;

text_color - цвет текста.

Рассмотрим пример эксперта, в котором полезно используются функции управления

графическими объектами.

Задача 32.Используя графический объект сообщить пользователю о

торговых критериях, определённых на основе показаний индикатора

MACD.

Как известно, индикатор MACD часто используется трейдерами для формирования

торговых критериев. Индикатор представлен двумя линиями - главной и сигнальной.

Считается, что торговый критерий срабатывает в момент пересечения указанных линий.

Если главная линия индикатора (обычно серая гистограмма) пересекает сверху вниз

сигнальную линию (обычно красную пунктирную), то нужно продавать, а если снизу

вверх, - то покупать. В промежутках между пересечениями линий индикатора необходимо

удерживать рыночные ордера, а в момент срабатывания противоположного критерия

зарывать их и одновременно открывать новые в противоположном направлении. Таким

образом, необходимо подготовить 4 вида сообщения: открытие Buy, открытие Sell,

удержание Buy и удержание Sell.

В данной задаче все сообщения являются взаимоисключающими, т.е. невозможна

ситуация, при которой возникает необходимость вывести на экран одновременно два или

более сообщений. Поэтому в данном случае можно использовать всего один графический

объект, постоянно присутствующий на экране, и по мере необходимости изменять

выводимый текст. Отобразим объект в правом верхнем углу окна финансового

инструмента, в котором будет работать эксперт. Поскольку положение объекта по ходу

торгов менять не предполагается, то удобно использовать объект типа OBJ_LABEL, т.к.

он позиционируется относительно окна финансового инструмента.

В качестве решения Задачи 32 рассмотрим эксперт grafobjects.mq4, использующий

графический объект OBJ_LABEL:

794

//--------------------------------------------------------------------

// grafobjects.mq4

// Предназначен для использования в качестве примера в учебнике MQL4.

//--------------------------------------------------------------------

int start() // Спец. функция start

{

//--------------------------------------------------------------- 1 --

int Sit;

double MACD_M_0,MACD_M_1, // Главная линия, 0 и 1 бар

MACD_S_0,MACD_S_1; // Сигнальная линия, 0 и 1 бар

string Text[4]; // Объявление строков. массива

color Color[4]; // Объявление массива цветов

Text[0]= "Открытие Buy"; // Текст для различных ситуаций

Text[1]= "Открытие Sell";

Text[2]= "Удерживаем Buy";

Text[3]= "Удерживаем Sell";

Color[0]= DeepSkyBlue; // Цвет объекта ..

Color[1]= LightPink; // .. для различных ситуаций

Color[2]= Yellow;

Color[3]= Yellow;

//--------------------------------------------------------------- 2 --

ObjectCreate("Label_Obj_MACD", OBJ_LABEL, 0, 0, 0);// Создание объ.

ObjectSet("Label_Obj_MACD", OBJPROP_CORNER, 1); // Привязка угол

ObjectSet("Label_Obj_MACD", OBJPROP_XDISTANCE, 10);// Координата Х

ObjectSet("Label_Obj_MACD", OBJPROP_YDISTANCE, 15);// Координата Y

//--------------------------------------------------------------- 3 --

MACD_M_0 =iMACD(NULL,0,12,26,9,PRICE_CLOSE,MODE_MAIN,0); // 0 бар

MACD_S_0 =iMACD(NULL,0,12,26,9,PRICE_CLOSE,MODE_SIGNAL,0);// 0 бар

MACD_M_1 =iMACD(NULL,0,12,26,9,PRICE_CLOSE,MODE_MAIN,1); // 1 бар

MACD_S_1 =iMACD(NULL,0,12,26,9,PRICE_CLOSE,MODE_SIGNAL,1);// 1 бар

//--------------------------------------------------------------- 4 --

// Анализ ситуации

if(MACD_M_1=MACD_S_0) // Персеч. снизу вверх

Sit=0;

if(MACD_M_1>MACD_S_1 && MACD_M_0<=MACD_S_0)// Персеч. сверху вниз

Sit=1;

if(MACD_M_1>MACD_S_1 && MACD_M_0>MACD_S_0) // Главная выше сигн.

Sit=2;

if(MACD_M_1

В блоке 1-2 эксперта определены переменные, в частности, заданы значения элементов

массивов Text[] и Color[], которые в дальнейшем используются для изменения свойств

объекта. В блоке 2-3 создаётся объект, и устанавливаются значения некоторых его

795

свойств. Разберём это блок подробно. Согласно этой строки кода эксперта в окне

финансового инструмента, в котором исполняется эксперт, создаётся графический объект:

ObjectCreate("Label_Obj_MACD", OBJ_LABEL, 0, 0, 0);// Создание объ.

Значение "Label_Obj_MACD" указывает, что объекту назначено такое имя (имя

создаваемому объекту присваивает программист по своему усмотрению). OBJ_LABEL -

идентификатор типа объекта, указывает, что создаваемый объект будет иметь такой тип

(выбирается из списка возможных типов). Первый из трёх последующих нолей указывает,

что объект создаётся в основном окне (основное окно, где отображается ценовой график,

всегда имеет индекс 0).

Следующие два ноля устанавливают для создаваемого объекта координаты, в

соответствии с которыми объект должен быть отображён в указанном окне. В данном

конкретном случае создаётся объект OBJ_LABEL, который не использует координаты

цены и времени. Обратите внимание, в описании функции ObjectCreate() указываются

только координаты цены и времени. Причём, для второй и третьей пары координат

имеются умолчательные значения, в то время как для первой пары координат

умолчательных значений нет. Это значит, что несмотря на то что для объекта OBJ_LABEL

вообще не требуются координаты цены и времени, в вызове функции ObjectCreate()

должны быть указаны какие-то значения. В данном случае указаны нули, можно было бы

указать другие значения, но и в том и в другом случае они всё равно игнорируются при

установлении свойств объекта OBJ_LABEL.

В последующих трёх строках программы (ранее созданному) объекту с именем

Label_Obj_MACD устанавливаются значения для некоторых его свойств:

ObjectSet("Label_Obj_MACD", OBJPROP_CORNER, 1); // Привязка угол

ObjectSet("Label_Obj_MACD", OBJPROP_XDISTANCE, 10);// Координата Х

ObjectSet("Label_Obj_MACD", OBJPROP_YDISTANCE, 15);// Координата Y

Для угла привязки (OBJPROP_CORNER) устанавливается значение 1, что означает

привязку к правому верхнему углу (ранее определённого основного) окна финансового

инструмента. В следующих двух строках устанавливаются значения дистанции в пикселях

от объекта до угла привязки: по горизонтали (OBJPROP_XDISTANCE) 10 пикселей и по

вертикали (OBJPROP_YDISTANCE) 15 пикселей. На этой стадии исполнения программы

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

Для того чтобы объект отобразил нужный текст, сначала необходимо вычислить каким

этот текст должен быть. Для этого сначала в блоке 3-4 определяется взаимное положение

796

индикаторных линий индикатора MACD на текущем и предыдущем барах, а затем в блоке

4-5 вычисляется значение Sit, соответствующее текущей ситуации (см. также Рис. 107 и

callstohastic.mq4)

В следующей строке определяются свойства объекта в зависимости от сложившейся

ситуации:

// Изменение свойств объекта

ObjectSetText("Label_Obj_MACD",Text[Sit],10,"Arial",Color[Sit]);

В результате исполнения функции ObjectSetText() объекту с именем Label_Obj_MACD

назначается текстовое описание, а именно значение строковой переменной Text[Sit]. Это

значение для разных ситуаций будет различным в зависимости от значения переменной

Sit. Например, если главная линия пересекла сигнальную сверху вниз, то в блоке 4-5

переменная Sit получит значение 1, в результате чего графическому объекту будет

назначено текстовое описание, содержащееся в элементе массива Text[1], а именно

"Открытие Sell". Следующие параметры: 10, "Arial" и Color[Sit] указывают размер,

название и цвет шрифта для текстового описания.

В результате исполнения эксперта в окне финансового инструмента EURUSD можно

наблюдать следующее:

Рис. 137. Результат работы эксперта grafobjects.mq4 в момент срабатывание критерия на

продажу.

На Рис. 137 видно, что в окне финансового инструмента имеется также подокно

индикатора MACD. Нужно заметить, что для полноценной работы эксперта наличие этого

индикатора в окне финансового инструмента не требуется, т.к. вычисление торговых

критериев в эксперте происходит в результате исполнения функции технического

797

индикатора, не связанной с выводом индикатора на экран. Здесь индикатор показан

только для того, чтобы можно было визуально определить момент срабатывания

торгового критерия и вывод необходимого для этого случая текстового описания

графического объекта. Эксперт будет работать аналогично и при всех других сочетаниях

взаимного положения индикаторных линий, всякий раз отображая описание,

соответствующее ситуации.

12.2.8 Удаление графических объектов

Рассмотренный выше эксперт grafobjects.mq4 имеет небольшой недостаток. По окончании

работы эксперта в окне финансового инструмента останется графический объект (при

этом его свойства будут такими, какими они были на момент последнего изменения).

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

некоторого момента, надпись Открытие Sell уже не будет соответствовать

действительности. Чтобы не вводить пользователя в заблуждение, графический объект

нужно удалить.

Для удаления любого графического объекта (независимо от способа его создания -

вручную или программно) достаточно выделить его и нажать клавишу Delete. Однако,

говоря о программировании, следует подчеркнуть, что правильно составленная программа

обязательно должна "почистить" после себя окно финансового инструмента. Иными

словами, в программе должен быть предусмотрен блок, в котором удаляются все

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

12.2.9 Функция ObjectDelete()

bool ObjectDelete(string name)

Удаление объекта с указанным именем. При успешном удалении функция возвращает

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

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

Параметры:

name - имя удаляемого объекта.

Использование функции ObjectDelete() крайне просто: достаточно указать имя удаляемого

объекта.

798

Для того чтобы устранить недоработку, допущенную в предыдущем примере, достаточно

дополнить эксперт grafobjects.mq4 специальной функцией deinit(), в которой и указать

функцию удаления объекта:

//--------------------------------------------------------------- 7 --

int deinit() // Спец. функция deinit

{

ObjectDelete("Label_Obj_MACD"); // Удаление объекта

return; // Выход из deinit()

}

//--------------------------------------------------------------- 8 --

При исполнении эксперта, дополненного функцией deinit() с таким кодом, объект с

именем Label_Obj_MACD будет удалён. В общем случае программа может создавать

множество объектов. Каждый из них может быть удалён программно в соответствии с

алгоритмом.

12.2.10 Модификация графических объектов

В ряде случаев требуется программно изменить положение объекта в окне финансового

инструмента. Чаще всего такая необходимость возникает по причине появления новых

баров. Например, торговые критерии в эксперте могут формироваться на основе канала

линейной регрессии, построенного на баровой истории определённой длительности

(например, по последним 50 барам). Если графический объект "канал линейной

регрессии" просто отобразить в окне финансового инструмента и в дальнейшем не

предпринимать никаких мер, то он всё время будет оставаться в том месте ценового

графика, где был установлен, и с появлением новых баров будет смещаться влево вместе с

историческими барами. Для того, чтобы этот графический объект не "съезжал", его

необходимо перерисовывать на каждом новом баре. Для этой цели необходимо вычислить

и сообщить объекту новые координаты, в соответствии с которыми объект должен быть

отображён в окне финансового инструмента.

Для того, чтобы узнать какие свойства имеются у графического объекта на текущий

момент, необходимо использовать функцию:

12.2.11 Функция ObjectGet()

double ObjectGet(string name, int prop_id)

799

Функция возвращает значение указанного свойства объекта. Для получения информации

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

Параметры:

name - имя объекта;

prop_id - идентификатор свойства объекта. Может быть любым из значений списка

свойств объекта.

Сообщение новых координат объекту осуществляется с помощью функции ObjectMove().

12.2.12 Функция ObjectMove()

bool ObjectMove(string name, int point, datetime time1, double price1)

Изменение одной из координат объекта на графике. Функция возвращает TRUE в случае

успеха, иначе FALSE. Для получения дополнительной информации об ошибке

необходимо вызвать функцию GetLastError(). Нумерация координат объекта начинается с

Параметры:

name - имя объекта;

point - индекс координаты (0-2);

time1 - новое значение времени;

price1 - новое значение цены.

Задача 33.Составить программу (эксперт), поддерживающую

отображение канала линейной регрессии для последних 50 баров.

Графический объект "канал линейной регрессии" использует две координаты времени.

Координаты цены (если они были назначены в программе) при построении этого объекта

клиентским терминалом игнорируются. Канал линейной регрессии вычисляется

клиентским терминалом на основе исторических цен и по своей сути не может быть

отображён в стороне от ценового графика. Поэтому отсутствие привязки этого объекта по

цене (игнорирование координат цены терминалом) является собственным неизменным

800

свойством этого объекта. Эксперт (moveobjects.mq4), управляющий положением

графического объекта может быть составлен так:

//--------------------------------------------------------------------

// moveobjects.mq4

// Предназначен для использования в качестве примера в учебнике MQL4.

//--------------------------------------------------------------------

extern int Len_Cn=50; // Длина канала (баров)

extern color Col_Cn=Orange; // Цвет канала

//--------------------------------------------------------------- 1 --

int init() // Спец. функция init()

{

Create(); // Вызов пользов. ф-ии создания

return; // Выход из init()

}

//--------------------------------------------------------------- 2 --

int start() // Спец. функция start()

{

datetime T2; // Вторая координата времени

int Error; // Код ошибки

//--------------------------------------------------------------- 3 --

T2=ObjectGet("Obj_Reg_Ch",OBJPROP_TIME2);// Запрос коорд. t2

Error=GetLastError(); // Получение кода ошибки

if (Error==4202) // Если объекта нет :(

{

Alert("Канал регрессии находится под управлением",

"\n Book_expert_82_2. Удалять нельзя.");

Create(); // Вызов пользов. ф-ии создания

T2=Time[0]; // Текущее значение коорд. t2

}

//--------------------------------------------------------------- 4 --

if (T2!=Time[0]) // Если объект не на месте

{

ObjectMove("Obj_Reg_Ch", 0, Time[Len_Cn-1],0); //Новая коорд. t1

ObjectMove("Obj_Reg_Ch", 1, Time[0], 0); //Новая коорд. t2

WindowRedraw(); // Перерисовка изображения

}

return; // Выход из start()

}

//--------------------------------------------------------------- 5 --

int deinit() // Спец. функция deinit()

{

ObjectDelete("Obj_Reg_Ch"); // Удаление объекта

return; // Выход из deinit()

}

//--------------------------------------------------------------- 6 --