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

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

431

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

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

оказывается полезным. Например, по звуку тиков можно судить о факте исполнения

эксперта. Другие звуки могут соответствовать иным событиям, например, срабатыванию

торгового критерия, закрытию ордера и т.д.

Значение действительной переменной Time_cur соответствует текущему серверному

времени. В эксперте анализируются условия, при которых необходимо вывести

диалоговое окно. Если в торговле имеется один или более ордеров, диалоговое окно ранее

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

менее, чем на 5 минут, то в программе выполняются определённые действия. Прежде

всего исполняется функция PlaySound(), воспроизводимый звук привлекает пользователя

обратить внимание на экран. Флаг Question получает значение true (в следующий раз

диалог не выводить). В следующей строке исполняется MessageBox():

int ret=MessageBox("Время важных новостей. Закрыть все ордера?",

"Вопрос", MB_YESNO|MB_ICONQUESTION|MB_TOPMOST); // Диалог. окно

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

"Время важных новостей. Закрыть все ордера?", а значение "Вопрос" будет отображено в

верхней строке панели. Флаг MB_YESNO определяет наличие кнопок - в данном случае

кнопки ДА и кнопки НЕТ (см. Коды возврата функции MessageBox). Флаг

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

(каждая операционная среда имеет свой набор иконок, на Рис. 133 показана иконка из

набора Widows XP). Флаг MB_TOPMOST наделяет диалоговое окно свойством "всегда

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

программы исполняются в текущий момент на компьютере пользователя. В результате

исполнения функции MessageBox() с указанными параметрами на экран выводится

диалоговое окно:

Рис. 133. Диалоговое окно, выводимое в результате исполнения функции MessageBox().

432

В момент, когда диалоговое окно выведено на экран, исполнение программы

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

диалоговом окне. Как только это произойдёт, управление будет передано в строку,

следующую за вызовом функции MessageBox(), в данном случае, в блок 3-4. Это свойство

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

необходимо учитывать при составлении программ. Например, если пользователь

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

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

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

этот период исполняться не будет.

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

звуком тиков. В момент вывода диалогового окна воспроизводится другой звук. А в

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

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

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

звук тиков возобновится.

Если пользователь нажал кнопку ДА, то в блоке 3-4 будет вызвана функция

Close_Orders(), предназначенная для закрытия всех ордеров. В данном примере

содержание этой функции не рассматривается, а для обозначения факта исполнения этой

функции исполняется Alert ("Работает функция закрытия всех ордеров."). Если

пользователь ответил НЕТ, то функция закрытия ордеров не вызывается. В текущем

сеансе исполнения эксперта диалоговое окно больше выводиться не будет.

9.3.1.4 Общие функции

Функция Краткое описание

Alert Отображает диалоговое окно, содержащие пользовательские данные.

Параметры могут быть любого типа. Количество параметров не может

превышать 64.

Comment Функция выводит комментарий, определенный пользователем, в левый

433

верхний угол графика. Параметры могут иметь любой тип. Количество

параметров не может превышать 64.

GetTickCount

Функция GetTickCount() возвращает количество миллисекунд,

прошедших с момента старта системы. Счетчик ограничен

разрешающей способностью системного таймера. Так как время

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

дней.

MarketInfo Возвращает различную информацию о финансовых инструментах,

перечисленных в окне "Обзор рынка". Часть информации о текущем

финансовом инструменте хранится в предопределенных переменных

(см. Идентификаторы функции MarketInfo()).

MessageBox Функция MessageBox создает и отображает окно сообщений, а также

управляет им. Окно сообщений содержит определенные приложением

сообщение и заголовок, любую комбинацию предопределенных

значков и командных кнопок. Если функция успешно выполняется,

возвращаемое значение - одно из значений кодов возврата

MessageBox(). Функцию нельзя вызывать из пользовательских

индикаторов, так как индикаторы выполняются в интерфейсном потоке

и не должны его тормозить

PlaySound Функция воспроизводит звуковой файл. Файл должен быть

расположен в каталоге каталог_терминала\sounds или его

подкаталоге.

Print Печатает некоторое сообщение в журнал экспертов. Параметры могут

иметь любой тип. Количество параметров не может превышать 64.

SendFTP Посылает файл по адресу, указанному в окне настроек на закладке

"Публикация". В случае неудачи возвращает FALSE. Функция не

работает в режиме тестирования. Из пользовательских индикаторов

434

также нельзя вызывать эту функцию. Отсылаемый файл должен

находиться в папке каталог_терминала\experts\files или ее подпапках.

Отсылка не производится, если в настройках не указан адрес FTP и/или

пароль доступа.

SendMail Посылает электронное письмо по адресу, указанному в окне настроек

на закладке "Почта". Отсылка может быть запрещена в настройках,

также может быть не указан адрес электронной почты.

Sleep Функция задерживает выполнение текущего эксперта или скрипта на

определенный интервал. Функцию Sleep() нельзя вызывать из

пользовательских индикаторов, так как индикаторы выполняются в

интерфейсном потоке и не должны его тормозить.

В функцию встроена проверка состояния флага остановки эксперта

каждую 0.1 секунды.

Для получения подробного описания этих и других функций необходимо обратиться к

справочной документации на MQL4.community, сайте MetaQuotes Software Corp. или к

разделу "Справка" в редакторе MetaEditor

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

Графический объект - это изображение в окне финансового инструмента, которое можно

выделить, переместить, изменить или удалить.

К графическим объектам относятся, например, горизонтальные и вертикальные линии,

канал линейной регрессии, уровни Фибоначчи, прямоугольник, текстовая метка и пр.

Такие изображения, как индикаторные линии, уровни индикатора, изображения свечей,

надписи, выводимые функцией Comment(), и др. выделить и удалить невозможно,

поэтому они не являются графическими объектами.

Графические объекты отображаются клиентским терминалом в окне финансового

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

зависимости от своего типа, имеет одну, две или три координаты и другие настраиваемые

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

435

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

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

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

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

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

координат и других параметров.

9.3.2.1 Способы позиционирования графических объектов

В MQL4 принято два способа позиционирования объектов: относительно ценового

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

продемонстрировать разницу между этими способами, установим вручную в окне

финансового инструмента два различных графических объекта: текст (OBJ_TEXT) и

текстовую метку (OBJ_LABEL). Для этого можно воспользоваться кнопками А и Т на

панели графических инструментов клиентского терминала. Установим размер окна таким

образом, чтобы оно занимало приблизительно половину площади экрана (Рис. 134).

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

(а также на горизонтальное и вертикальное масштабирование ценового графика).

Рис. 134. Графические объекты с различными способами позиционирования в окне

финансового инструмента.

9.3.2.2 Позиционирование относительно окна финансового инструмента

436

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

изменять путём перемещения его правой или нижней границы. Если же размер окна

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

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

Это происходит потому, что позиционирование графического объекта OBJ_LABEL

осуществляется относительно границ окна финансового инструмента. В данном случае

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

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

указанной точки привязки задаются в пикселях - 193 и 48 на Рис. 135.

Рис. 135. Настройки графического объекта OBJ_LABEL.

Точкой отсчёта координат самого объекта (в данном случае) является верхний левый угол

курсорной рамки, видимой при выделении объекта мышью. В левом верхнем углу

курсорной рамки можно видеть небольшую точку, свидетельствующую о настройках

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

курсорной рамке точка будет указана в другом углу.

При появлении в окне финансового инструмента новых баров объект типа OBJ_LABEL

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

Использование этого объекта удобно в том случае, если необходимо вывести на экран

текстовую информацию общего характера, например, о прекращении торгов, изменении

брокером значения ограничивающей дистанции для ордеров и пр.

9.3.2.3 Позиционирование относительно ценового графика

437

При любом способе изменения размеров окна, а также при масштабировании ценового

графика объект типа OBJ_TEXT не меняет своего положения относительно ценового

графика. Точкой отсчёта координат для этого объекта является середина верхней линии

курсорной рамки, координатой по оси Х - время, а по оси Y - цена по финансовому

инструменту (Рис. 136).

Рис. 136. Настройки графического объекта OBJ_TEXT.

По мере появления в окне финансового инструмента новых баров место положения

графического объекта OBJ_TEXT относительно ценового графика не изменяется, т.е. с

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

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

левой границы окна финансового инструмента.

Тот или иной способ позиционирования является собственным свойством графического

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

программно. Большинство графических объектов позиционируются относительно

ценового графика, т.е. в координатах цены и времени.

9.3.2.4 Создание графических объектов и изменение их свойств

Создать графический объект - это значит установить в окне финансового инструмента

один из объектов предопределённого типа (см. Типы и свойства графических объектов).

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

438

9.3.2.5 Функция ObjectCreate()

bool ObjectCreate(string name, int type, int window, datetime time1, double

price1,

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 - цена третьей координаты.

439

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

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

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

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

9.3.2.6 Функция ObjectSet()

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

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

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

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

Параметры:

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

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

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

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

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

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

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

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

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

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

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

9.3.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. Для объектов других типов

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

440

Параметры:

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

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

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

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

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

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

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

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

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

MACD.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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