Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
451
Если анализ ошибки показал, что объекта нет, значит его надо вновь создать, уведомив
пользователя о недопустимых действиях (программа не удаляет объект в процессе работы,
значит объект удалён пользователем). Поэтому после вывода сообщения в программе
выполняется обращение к ранее рассмотренной пользовательской функции Create(), в
результате чего объект снова создаётся в окне финансового инструмента.
К моменту, когда исполняется следующий блок (4-5), графический объект обязательно
присутствует. Чтобы решить, надо ли его двигать, следует знать, каково положение
объекта на текущий момент. Для этого достаточно проанализировать (ранее полученное)
значение первой координаты объекта, и если это значение не совпадает со временем
открытия нулевого бара, то сообщить объекту новые координаты.
Изменение координат объекта осуществляется с помощью функции ObjectMove():
ObjectMove("Obj_Reg_Ch", 0, Time[Len_Cn-1],0); //Новая коорд. t1
ObjectMove("Obj_Reg_Ch", 1, Time[0], 0); //Новая коорд. t2
Здесь объекту с именем Obj_Reg_Ch для первой координаты (координата 0)
устанавливается значение Time[Len_Cn-1], а для второй координаты (координата 1) -
Time[0]. Последним среди передаваемых в функцию ObjectMove() параметров указан 0.
Это - координата цены, которую в соответствии с описанием функции передавать
необходимо, но которое в данном случае будет проигнорировано клиентским терминалом.
В результате исполнения этих строк свойства указанного графического объекта будут
изменены, а в результате последующего исполнения функции WindowRedraw()
графический объект будет принудительно перерисован клиентским терминалом - теперь
уже соответственно новым значениям координат.
Таким образом, при исполнении функции start() графический объект "канал линейной
регрессии" будет перерисовываться клиентским терминалом всякий раз при образовании
нового бара, на первом же его тике (см. рис. 139). По окончании выполнения эксперта в
окне финансового инструмента, в момент исполнения специальной функции deinit(),
указанный объект будет удалён (т.е. программа "подметёт" после работы своё рабочее
место).
452
Рис. 139. Отображение канала линейной регрессии при исполнении эксперта
moveobjects.mq4.
В общем случае можно создавать и удалять графические объекты в зависимости от
некоторых вычисленных в программе условий. Можно отображать линии поддержки и
сопротивления (OBJ_TREND), вертикальными линиями (OBJ_VLINE) отмечать время
приближающихся значительных событий, текстовыми объектами (OBJ_LABEL и
OBJ_TEXT) указывать пересечения различных линий, прогнозируемое направление
движения цены и т.д.
Отдельно нужно заметить, что в ряде случаев использование графических объектов не
требуется. Например, если есть необходимость вывести на экран множество простых
однотипных изображений (например, стрелки), то для этого можно воспользоваться
индикаторными линиями, соответствующим образом настроив стиль линий. Такой подход
избавит от необходимости отслеживать в программе множество координат объектов и
предотвратит возможность случайного удаления изображения (значки, отображающие
индикаторные линии, невозможно ни выделить, ни удалить).
9.3.2.14 Функции для работы с графическими объектами
Функция Краткое описание
ObjectCreate Создание объекта с указанным именем, тип и начальные
координаты в указанном подокне графика. Число
453
координат, связываемых с объектом, может быть от 1 до 3 в
зависимости от типа. При успешном создании объекта
функция возвращает TRUE, иначе FALSE.
ObjectDelete Удаление объекта с указанным именем. При успешном
удалении функция возвращает TRUE, иначе FALSE
ObjectDescription Функция возвращает описание объекта. Для объектов типа
OBJ_TEXT и OBJ_LABEL возвращается текст,
отображаемый этими объектами.
ObjectFind Поиск объекта с указанным именем. Функция возвращает
индекс окна, которому принадлежит искомый объект. В
случае неудачи функция вернет -1.
ObjectGet Функция возвращает значение указанного свойства
объекта.
ObjectGetFiboDescription
Функция возвращает описание уровня объекта Фибоначчи.
Количество уровней зависит от типа объекта,
принадлежащего к группе объектов Фибоначчи.
Максимальное количество уровней - 32.
ObjectGetShiftByValue Функция вычисляет и возвращает номер бара (смещение
относительно текущего бара) для указанной цены. Номер
бара вычисляется при помощи линейного уравнения по
первой и второй координатам. Применяется для трендовых
линий и аналогичных объектов.
ObjectGetValueByShift Функция вычисляет и возвращает значение цены для
указанного бара (смещение относительно текущего бара).
Значение цены вычисляется при помощи линейного
уравнения по первой и второй координатам. Применяется
454
для трендовых линий и аналогичных объектов.
ObjectMove Изменение одной из координат объекта на графике.
Объекты могут иметь от одной до трех точек привязки в
зависимости от типа объекта. Функция возвращает TRUE в
случае успеха, иначе FALSE.
ObjectName Функция возвращает имя объекта по порядковому номеру в
списке объектов.
ObjectsDeleteAll Удаление всех объектов с указанным типом и в указанном
подокне графика. Функция возвращает число удаленных
объектов.
ObjectSet Изменение значения указанного свойства объекта. В случае
успеха функция возвращает TRUE, иначе FALSE
ObjectSetFiboDescription
Функция присваивает новое описание уровню объекта
Фибоначчи. Количество уровней зависит от типа объекта
Фибоначчи. Максимальное количество уровней - 32.
ObjectSetText Изменение описания объекта. Для объектов OBJ_TEXT и
OBJ_LABEL это описание отображается на графике в виде
текстовой строки. В случае успеха функция возвращает
значение TRUE, иначе FALSE.
ObjectsTotal Возвращает общее число объектов указанного типа на
графике.
ObjectType Функция возвращает тип указанного объекта.
455
Для получения подробного описания этих и других функций необходимо обратиться к
справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к
разделу "Справка" в редакторе MetaEditor
9.3.3 Операции с графиками
Обычно во время практической работы трейдер открывает в окне финансового
инструмента несколько подокон, в которых отображаются индикаторы. Порядок вывода
индикаторов не лимитирован - они могут располагаться в любой последовательности.
Количество подокон в окне финансового инструмента не ограничено. Все подокна имеют
свой номер. Основное окно, в котором отображается ценовой график, имеется всегда, его
номер 0. Каждое из подокон индикаторов также имеют номер. Соблюдается простой
порядок нумерации подокон - в порядке представления в окне финансового инструмента в
направлении сверху вниз: подокно индикатора, ближайшее к основному, имеет номер 1,
следующее нижнее имеет номер 2, следующее - номер 3 и т.д.
Рис. 140. Расположение подокон в окне финансового инструмента.
Количество подокон можно легко вычислить с помощью функции:
int WindowsTotal()
Функция возвращает количество подокон индикаторов на графике, включая главное окно
графика. Максимальный номер (самого нижнего) окна всегда на 1 меньше, чем общее
количество подокон (включая основное, с номером 0) в окне финансового инструмента.
456
Если в ситуации, изображённой на рис. 140, из любой прикладной программы вызвать для
исполнения функцию WindowsTotal(), то возвращённое ею значение будет равно 3, в то
время как максимальный номер (самого нижнего) подокна равен 2.
Указанный порядок нумерации окон сохраняется в случаях, если добавляется новое
подокно индикатора или удаляется любое из имеющихся. В случае добавления нового
окна, оно отображается ниже всех других подокон и получает соответствующий номер, на
1 больше, чем номер вышестоящего окна. Если же какое-либо из подокон удаляется из
окна финансового инструмента, то все подокна, находящиеся ниже него, автоматически
перенумеруются - номер каждого из них уменьшается на 1.
В MQL4 предусмотрена возможность создавать графические объекты (и изменять их
свойства) в любом из имеющихся подокон. Для этого в функции ObjectCreate()
предусмотрен параметр window, согласно которому объект создаётся в указанном подокне
окна финансового инструмента. Текущий номер подокна можно вычислить с помощью
функции:
int WindowFind(string name)
Функция возвращает номер подокна графика, содержащего индикатор с указанным
именем name, если он найден, иначе возвращается -1. Функция также возвращает -1, если
пользовательский индикатор ищет сам себя в процессе инициализации init().
Параметры:
name - короткое имя индикатора.
Количество подокон в окне финансового инструмента может измениться в любой момент
в результате удаления пользователем какого-либо из индикаторов. Поэтому алгоритм
прикладной программы, поддерживающей управление графическими объектами, должен
предусматривать постоянное отслеживание номеров окон, в которых отображаются
индикаторы.
Задача 34. Используя графические объекты, отобразить сообщения о
показаниях двух индикаторов. Если в окне финансового инструмента
установлен соответствующий индикатор, то графический объект
457
выводить в окно индикатора, в противном случае - в основное окно.
Для решения задачи выберем индикаторы RSI и Momentum. Общий алгоритм построения
эксперта сводится к следующему. В функции init() можно задать тексты, которые будут
выводиться на экран в зависимости от показаний индикаторов, т.е. выполнить те
вычисления, которые выполняются в программе один раз. В функции start() необходимо
вычислить показания индикаторов, определить наличие необходимых подокон и их
номера, а затем, в зависимости от ситуации, выдать то или иное сообщение в то или иное
подокно. При исполнении функции deinit() необходимо удалить все графические объекты,
созданные в процессе работы программы. Ниже представлен эксперт charts.mq4,
управляющий графическими объектами в подокнах окна финансового инструмента.
//--------------------------------------------------------------------
// charts.mq4
// Предназначен для использования в качестве примера в учебнике MQL4.
//--------------------------------------------------------------- 1 --
int Win_Mom_old=0, // Старый номер подокна Moment.
Win_RSI_old=0; // Старый номер подокна RSI
color Color[5]; // Объявление массива цветов
string Text[5]; // Объявление строков. массива
//--------------------------------------------------------------- 2 --
int init() // Спец. функция init()
{
Win_RSI_old=0; // Технический момент
Win_Mom_old=0; // Технический момент
Text[0]= "RSI(14) ниже 30. Buy"; // Тексты для ситуаций RSI
Text[1]= "RSI(14) выше 70. Sell"; // Тексты для ситуаций RSI
Text[2]= "RSI(14) между 30 и 70"; // Тексты для ситуаций RSI
Text[3]= "Моментум(14) повышается"; // Тексты для ситуаций Моментум
Text[4]= "Моментум(14) снижается"; // Тексты для ситуаций Моментум
Color[0]= DeepSkyBlue; // Цвет объектов для ..
Color[1]= LightPink; // .. различных ситуаций ..
Color[2]= Orange; // .. индикатора RSI
Color[3]= Color[0]; // Те же цвета для Моментум
Color[4]= Color[1]; // Те же цвета для Моментум
Create_RSI(0); // Создание первого объекта
Create_Mom(0); // Создание второго объекта
Main(); // Вызов пользовательской ф-ии
return; // Выход из init()
}
458
//--------------------------------------------------------------- 3 --
int start() // Спец. функция start
{
Main(); // Вызов пользовательской ф-ии
return; // Выход из start()
}
//--------------------------------------------------------------- 4 --
int deinit() // Спец. функция deinit()
{
ObjectDelete("Obj_RSI"); // Удаление объекта
ObjectDelete("Obj_Mom"); // Удаление объекта
return; // Выход из deinit()
}
//--------------------------------------------------------------- 5 --
int Main() // Пользовательская функция
{
int // Целые переменные
Win_RSI_new=0, // Новый номер подокна RSI
Win_Mom_new=0, // Новый номер подокна Moment.
Ind_RSI, Ind_Mom; // Индексы для ситуаций
double // Действительные переменные
RSI, // Значение RSI на 0 баре
Mom_0, Mom_1; // Значение Mom на 0 и 1 барах
//--------------------------------------------------------------- 6 --
RSI=iRSI(NULL,0,14,PRICE_CLOSE,0); // RSI(14) на нулевом баре
Ind_RSI=2; // RSI между уровнями 30 и 70
if(RSI < 30)Ind_RSI=0; // RSI внизу. Нужно покупать
if(RSI > 70)Ind_RSI=1; // RSI вверху. Нужно продавать
//--------------------------------------------------------------- 7 --
Win_RSI_new=WindowFind("RSI(14)"); // Номер окна индикатора RSI
if(Win_RSI_new==-1) Win_RSI_new=0; // Если нет индик, то осн. окно
if(Win_RSI_new!=Win_RSI_old) // Удалено или установлено ..
{ // .. окно индикатора RSI
ObjectDelete("Obj_RSI"); // Удаление объекта
Create_RSI(Win_RSI_new); // Создаём объект в нужном окне
Win_RSI_old=Win_RSI_new; // Запомним это окно
} // Изменяем текстовое описание:
ObjectSetText("Obj_RSI",Text[Ind_RSI],10,"Arial",Color[Ind_RSI]);
//--------------------------------------------------------------- 8 --
Mom_0=iMomentum(NULL,0,14,PRICE_CLOSE,0);// Значен. на нулевом баре
Mom_1=iMomentum(NULL,0,14,PRICE_CLOSE,1);// Знач. на предыдущ. баре
if(Mom_0 >=Mom_1)Ind_Mom=3; // Индик. линия поднимается
if(Mom_0 < Mom_1)Ind_Mom=4; // Индик. линия опускается
//--------------------------------------------------------------- 9 --
Win_Mom_new=WindowFind("Momentum(14)");// Номер окна индик. Momen
if(Win_Mom_new==-1) Win_Mom_new=0; // Если нет индик, то осн. окно
459
if(Win_Mom_new!=Win_Mom_old) // Удалено или установлено ..
{ // .. окно индикатора Momentum
ObjectDelete("Obj_Mom"); // Удаление объекта
Create_Mom(Win_Mom_new); // Создаём объект в нужном окне
Win_Mom_old=Win_Mom_new; // Запомним это окно
} // Изменяем текстовое описание:
ObjectSetText("Obj_Mom",Text[Ind_Mom],10,"Arial",Color[Ind_Mom]);
//-------------------------------------------------------------- 10 --
WindowRedraw(); // Перерисовка изображения
return; // Выход из пользоват. функции
}
//-------------------------------------------------------------- 11 --
int Create_RSI(int Win) // Пользовательс ф-ия
{ // ..создания объекта
ObjectCreate("Obj_RSI",OBJ_LABEL, Win, 0,0); // Создание объекта
ObjectSet("Obj_RSI", OBJPROP_CORNER, 0); // Привязка к углу
ObjectSet("Obj_RSI", OBJPROP_XDISTANCE, 3); // Координата Х
if (Win==0)
ObjectSet("Obj_RSI",OBJPROP_YDISTANCE,20);// Координата Y
else
ObjectSet("Obj_RSI",OBJPROP_YDISTANCE,15);// Координата Y
return; // Выход из польз.ф-ии
}
//-------------------------------------------------------------- 12 --
int Create_Mom(int Win) // Пользовательс ф-ия
{ // ..создания объекта
ObjectCreate("Obj_Mom",OBJ_LABEL, Win, 0,0); // Создание объекта
ObjectSet("Obj_Mom", OBJPROP_CORNER, 0); // Привязка к углу
ObjectSet("Obj_Mom", OBJPROP_XDISTANCE, 3); // Координата Х
if (Win==0)
ObjectSet("Obj_Mom",OBJPROP_YDISTANCE, 5);// Координата Y
else
ObjectSet("Obj_Mom",OBJPROP_YDISTANCE,15);// Координата Y
return; // Выход из польз.ф-ии
}
//-------------------------------------------------------------- 13 --
Прежде чем рассматривать представленный код, необходимо указать на специфику
работы программы. Предполагается, что однажды созданный графический объект (в
данном случае отображающий текст) будет присутствовать на экране постоянно
(непрерывно), и его текстовое описание будет характеризовать ситуацию. Изменять
содержание текстового описания необходимо при исполнении функции start(), на каждом
тике. В то же время, при переключении таймфреймов для окна, к которому прикреплён
эксперт, программа проходит стадии deinit(), init(), (ожидание тика) и start(). Если первый
460
раз объект создаётся в процессе исполнения start(), то всякий раз при переключении
таймфрейма до появления объекта будет проходить некоторое время, равное времени
ожидания очередного тика. Это очень неудобно, в особенности, если происходит частое
переключение таймфреймов.
В правильно построенной программе необходимые сообщения выводятся на экран в
момент присоединения программы к окну финансового инструмента или в момент
переключения таймфрейма (т.е. ещё до поступления нового тика). Для этого на этапе
исполнения специальной функции init(), как правило, необходимо выполнить все
действия, которые будут выполняться на каждом тике при запуске специальной функции
start(). Чтобы не повторять в разных специальных функциях один и тот же программный
код, его можно организовать в виде отдельной функции. Для этой цели в эксперте создана
пользовательская функция Main(). Она вызывается для исполнения один раз на этапе
инициализации (блок 2-3) и на каждом тике в процессе последующей работы эксперта
(блок 3-4).
В программе (блок 11-13) имеются ещё две пользовательские функции - Create_RSI() и
Create_Mom(), предназначенные для создания и изменения свойств объектов. При
исполнении функции init() с помощью этих функций создаются необходимые объекты, а
вызов на исполнение функции Main() приводит к наделению объектов необходимыми
свойствами (отражение в нужном окне объектов с нужным текстовым описанием нужного
цвета).
Рассмотрим функцию Main() (блок 5-11) подробно. В блоке 6-7 вычисляются показания
индикатора RSI. В зависимости от того, находится ли конец индикаторной линии выше
70, ниже 30 или в промежутке между ними, переменной Ind_RSI присваивается то или
иное значение. В дальнейшем это значение используется в качестве индекса массивов
Color[] и Text[] (в блоке 7-8) для изменения свойств графического объекта с именем
"Obj_RSI".
Блок 7-8. Номер окна индикатора RSI вычисляется в строке:
Win_RSI_new = WindowFind("RSI(14)");// Номер окна индикатора RSI
В качестве передаваемого параметра используется строковое значение "RSI(14)". Это -
короткое имя индикатора, номер которого определяется. В данном случае вся
последовательность литер в указанной строке, включая скобки и цифры, является
названием. Нужно заметить, что в общем случае в окне финансового инструмента могут