Ковалев Сергей. Программирование на алгоритмическом языке MQL4
Подождите немного. Документ загружается.
801
int Create() // Пользовательская функция..
{ // ..создания объекта
datetime T1=Time[Len_Cn-1]; // Определение 1 коорд времени
datetime T2=Time[0]; // Определение 2 коорд времени
ObjectCreate("Obj_Reg_Ch",OBJ_REGRESSION,0,T1,0,T2,0);// Создание
ObjectSet( "Obj_Reg_Ch", OBJPROP_COLOR, Col_Cn); // Цвет
ObjectSet( "Obj_Reg_Ch", OBJPROP_RAY, false); // Луч
ObjectSet( "Obj_Reg_Ch", OBJPROP_STYLE, STYLE_DASH);// Стиль
ObjectSetText("Obj_Reg_Ch","Создан экспертом moveobjects",10);
WindowRedraw(); // Перерисовка изображения
}
//--------------------------------------------------------------- 7 --
Алгоритм эксперта moveobjects.mq4 предполагает, что однажды выставленный
графический объект будет оставаться на экране в течение всего времени исполнения
программы. В подобных случаях имеет смысл использовать в программе
пользовательскую функцию (здесь это функция Create(), блок 6-7) для создания объекта и
обращаться к ней из программы по мере необходимости. Для отображения объекта
необходимы две координаты времени (Т1 - координата левой границы объекта и Т2 -
координата правой границы):
datetime T1 = Time[Len_Cn-1]; // Определение 1 коорд времени
datetime T2 = Time[0]; // Определение 2 коорд времени
В данном примере правая граница графического объекта должна всегда находиться на
нулевом баре, поэтому значение второй координаты совпадает со временем открытия
нулевого бара. Левая координата вычисляется в зависимости от заданного пользователем
количества баров (внешняя переменная Len_Cn) и определяется как время открытия бара с
соответствующим индексом. Например, если длина канала составляет 50 баров, то левая
координата объекта будет равна времени открытия бара с индексом 49.
В следующих строках пользовательской функции Create() с помощью ObjectCreate()
создаётся объект OBJ_REGRESSION, и с помощью ObjectSet() созданный объект
наделяется необходимыми свойствами (заданный пользователем во внешней переменной
цвет, запрещено рисовать объект как луч, стиль линии - пунктирная). В строке:
ObjectSetText("Obj_Reg_Ch","Создан экспертом moveobjects",10);
объекту сообщается текстовое описание. В отличие от ранее рассмотренного объекта
OBJ_LABEL, текстовое описание объекта OBJ_REGRESSION не выводится на экран.
Текстовое описание графических объектов можно увидеть на панели свойств объектов.
802
Это очень удобно использовать во время практической работы для того, чтобы отличить
объекты, созданные программой, от объектов, выставленных пользователем вручную:
Рис. 138. Общие свойства графического объекта "канал линейной регрессии", созданного
экспертом moveobjects.mq4.
В программе используется ещё одна функция, с помощью которой перерисовывается
текущий график:
WindowRedraw(); // Перерисовка изображения
12.2.13 Функция WindowRedraw()
void WindowRedraw()
Функция принудительно перерисовывает текущий график. Обычно применяется после
изменения свойств объектов.
Обычный порядок отображения графических объектов клиентским терминалом
предусматривает фактическое изменение изображения в момент поступления нового тика.
Поэтому, если не использовать WindowRedraw(), то изменения свойств объекта
становятся видимы пользователю на следующем тике, т.е. процесс отображения
постоянно запаздывает на один тик. Использование WindowRedraw() позволяет
принудительно перерисовать все объекты в нужный момент, например, сразу после
изменения свойств объектов. В общем случае, если в программе изменяются свойства
нескольких объектов, то функцию WindowRedraw() достаточно использовать один раз,
после изменения свойств последнего из объектов.
Первое обращение к пользовательской функции осуществляется из специальной функции
init(). В момент прикрепления эксперта к окну финансового инструмента начнётся
803
исполнение init(), в результате чего графический объект "канал линейной регрессии"
отобразится в окне финансового инструмента.
В функции start() рассматривается две возможных ситуации: когда объект случайно
удалён пользователем (блок 3-4) и когда объект необходимо переместить вправо при
образовании нового нулевого бара (блок 4-5). Для того чтобы определить, существует ли
вообще графический объект на текущий момент, достаточно запросить значение одной из
его координат. Если объект существует, то функция ObjectGet() вернёт некоторое
значение, соответствующее запрошенной координате, а функция GetLastError() вернёт
нулевое значение (т.е. при запросе координаты ошибка не возникла). Если же объекта с
заданным именем в окне финансового инструмента нет, то функция GetLastError() вернёт
код ошибки 4202, т.е. объект не существует:
T2=ObjectGet("Obj_Reg_Ch",OBJPROP_TIME2); // Запрос коорд. t2
Error=GetLastError(); // Получение кода ошибки
Если анализ ошибки показал, что объекта нет, значит его надо вновь создать, уведомив
пользователя о недопустимых действиях (программа не удаляет объект в процессе работы,
значит объект удалён пользователем). Поэтому после вывода сообщения в программе
выполняется обращение к ранее рассмотренной пользовательской функции 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()
804
графический объект будет принудительно перерисован клиентским терминалом - теперь
уже соответственно новым значениям координат.
Таким образом, при исполнении функции start() графический объект "канал линейной
регрессии" будет перерисовываться клиентским терминалом всякий раз при образовании
нового бара, на первом же его тике (см. рис. 139). По окончании выполнения эксперта в
окне финансового инструмента, в момент исполнения специальной функции deinit(),
указанный объект будет удалён (т.е. программа "подметёт" после работы своё рабочее
место).
Рис. 139. Отображение канала линейной регрессии при исполнении эксперта
moveobjects.mq4.
В общем случае можно создавать и удалять графические объекты в зависимости от
некоторых вычисленных в программе условий. Можно отображать линии поддержки и
сопротивления (OBJ_TREND), вертикальными линиями (OBJ_VLINE) отмечать время
приближающихся значительных событий, текстовыми объектами (OBJ_LABEL и
OBJ_TEXT) указывать пересечения различных линий, прогнозируемое направление
движения цены и т.д.
Отдельно нужно заметить, что в ряде случаев использование графических объектов не
требуется. Например, если есть необходимость вывести на экран множество простых
однотипных изображений (например, стрелки), то для этого можно воспользоваться
индикаторными линиями, соответствующим образом настроив стиль линий. Такой подход
избавит от необходимости отслеживать в программе множество координат объектов и
предотвратит возможность случайного удаления изображения (значки, отображающие
индикаторные линии, невозможно ни выделить, ни удалить).
805
12.2.14 Функции для работы с графическими объектами
Функция Краткое описание
ObjectCreate Создание объекта с указанным именем, тип и начальные
координаты в указанном подокне графика. Число
координат, связываемых с объектом, может быть от 1 до 3 в
зависимости от типа. При успешном создании объекта
функция возвращает TRUE, иначе FALSE.
ObjectDelete Удаление объекта с указанным именем. При успешном
удалении функция возвращает TRUE, иначе FALSE
ObjectDescription Функция возвращает описание объекта. Для объектов типа
OBJ_TEXT и OBJ_LABEL возвращается текст,
отображаемый этими объектами.
ObjectFind Поиск объекта с указанным именем. Функция возвращает
индекс окна, которому принадлежит искомый объект. В
случае неудачи функция вернет -1.
ObjectGet Функция возвращает значение указанного свойства
объекта.
ObjectGetFiboDescription
Функция возвращает описание уровня объекта Фибоначчи.
Количество уровней зависит от типа объекта,
принадлежащего к группе объектов Фибоначчи.
Максимальное количество уровней - 32.
ObjectGetShiftByValue Функция вычисляет и возвращает номер бара (смещение
относительно текущего бара) для указанной цены. Номер
бара вычисляется при помощи линейного уравнения по
806
первой и второй координатам. Применяется для трендовых
линий и аналогичных объектов.
ObjectGetValueByShift Функция вычисляет и возвращает значение цены для
указанного бара (смещение относительно текущего бара).
Значение цены вычисляется при помощи линейного
уравнения по первой и второй координатам. Применяется
для трендовых линий и аналогичных объектов.
ObjectMove Изменение одной из координат объекта на графике.
Объекты могут иметь от одной до трех точек привязки в
зависимости от типа объекта. Функция возвращает TRUE в
случае успеха, иначе FALSE.
ObjectName Функция возвращает имя объекта по порядковому номеру в
списке объектов.
ObjectsDeleteAll Удаление всех объектов с указанным типом и в указанном
подокне графика. Функция возвращает число удаленных
объектов.
ObjectSet Изменение значения указанного свойства объекта. В случае
успеха функция возвращает TRUE, иначе FALSE
ObjectSetFiboDescription
Функция присваивает новое описание уровню объекта
Фибоначчи. Количество уровней зависит от типа объекта
Фибоначчи. Максимальное количество уровней - 32.
ObjectSetText Изменение описания объекта. Для объектов OBJ_TEXT и
OBJ_LABEL это описание отображается на графике в виде
текстовой строки. В случае успеха функция возвращает
значение TRUE, иначе FALSE.
807
ObjectsTotal Возвращает общее число объектов указанного типа на
графике.
ObjectType Функция возвращает тип указанного объекта.
Для получения подробного описания этих и других функций необходимо обратиться к
справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к
разделу "Справка" в редакторе MetaEditor
12.3 Операции с графиками
Обычно во время практической работы трейдер открывает в окне финансового
инструмента несколько подокон, в которых отображаются индикаторы. Порядок вывода
индикаторов не лимитирован - они могут располагаться в любой последовательности.
Количество подокон в окне финансового инструмента не ограничено. Все подокна имеют
свой номер. Основное окно, в котором отображается ценовой график, имеется всегда, его
номер 0. Каждое из подокон индикаторов также имеют номер. Соблюдается простой
порядок нумерации подокон - в порядке представления в окне финансового инструмента в
направлении сверху вниз: подокно индикатора, ближайшее к основному, имеет номер 1,
следующее нижнее имеет номер 2, следующее - номер 3 и т.д.
808
Рис. 140. Расположение подокон в окне финансового инструмента.
Количество подокон можно легко вычислить с помощью функции:
int WindowsTotal()
Функция возвращает количество подокон индикаторов на графике, включая главное окно
графика. Максимальный номер (самого нижнего) окна всегда на 1 меньше, чем общее
количество подокон (включая основное, с номером 0) в окне финансового инструмента.
Если в ситуации, изображённой на рис. 140, из любой прикладной программы вызвать для
исполнения функцию WindowsTotal(), то возвращённое ею значение будет равно 3, в то
время как максимальный номер (самого нижнего) подокна равен 2.
Указанный порядок нумерации окон сохраняется в случаях, если добавляется новое
подокно индикатора или удаляется любое из имеющихся. В случае добавления нового
окна, оно отображается ниже всех других подокон и получает соответствующий номер, на
1 больше, чем номер вышестоящего окна. Если же какое-либо из подокон удаляется из
окна финансового инструмента, то все подокна, находящиеся ниже него, автоматически
перенумеруются - номер каждого из них уменьшается на 1.
В MQL4 предусмотрена возможность создавать графические объекты (и изменять их
свойства) в любом из имеющихся подокон. Для этого в функции ObjectCreate()
предусмотрен параметр window, согласно которому объект создаётся в указанном подокне
окна финансового инструмента. Текущий номер подокна можно вычислить с помощью
функции:
int WindowFind(string name)
809
Функция возвращает номер подокна графика, содержащего индикатор с указанным
именем name, если он найден, иначе возвращается -1. Функция также возвращает -1, если
пользовательский индикатор ищет сам себя в процессе инициализации init().
Параметры:
name - короткое имя индикатора.
Количество подокон в окне финансового инструмента может измениться в любой момент
в результате удаления пользователем какого-либо из индикаторов. Поэтому алгоритм
прикладной программы, поддерживающей управление графическими объектами, должен
предусматривать постоянное отслеживание номеров окон, в которых отображаются
индикаторы.
Задача 34. Используя графические объекты, отобразить сообщения о
показаниях двух индикаторов. Если в окне финансового инструмента
установлен соответствующий индикатор, то графический объект
выводить в окно индикатора, в противном случае - в основное окно.
Для решения задачи выберем индикаторы 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 --
810
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()
}
//--------------------------------------------------------------- 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) на нулевом баре