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

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

Стандартные константы, перечисления и структуры

331

указано ни FILE_CSV, ни FILE_BIN, ни FILE_TXT, то подразумевается FILE_CSV.

Если файл открыт на чтение как текстовый (FILE_TXT или FILE_CSV), и при этом в начале файла

будет обнаружен специальный двухбайтовый признак 0xff,0xfe, то флаг кодировки будет

FILE_UNICODE, даже если указан флаг FILE_ANSI.

Смотри также

Файловые операции

Стандартные константы, перечисления и структуры

332

Позиционирование внутри файла

Большая часть файловых функций связана с операциями чтения/записи информации. При этом с

помощью функции FileSeek() можно указывать положение файлового указателя на позицию внутри

файла, с которой будет производится следующая операция чтения или записи. Перечисление

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

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

ENUM_FILE_POSITION

Идентификатор

Описание

SEEK_SET

Начало файла

SEEK_CUR

Текущая позиция файлового указателя

SEEK_END

Конец файла

Смотри также

FileIsEnding, FileIsLineEnding

Стандартные константы, перечисления и структуры

333

Использование кодовой страницы в операциях

преобразования строк

При операциях конвертации строковых переменных в массивы типа char и обратно в языке MQL5

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

системы Windows (CP_ACP). Если требуется указать иной тип кодировки, то его можно задать

дополнительным параметром для функций CharArrayToString(), StringToCharArray() и FileOpen().

В таблице приведены встроенные константы для некоторых наиболее востребованных кодовых

страниц. Неперечисленные кодовые страницы можно указать кодом, соответствующим этой

странице.

Встроенные константы кодовых страниц

Константа

Значение

Описание

CP_ACP

Текущая кодовая страница

ANSI кодировка в

операционной системе

Windows

CP_OEMCP

Текущая кодовая страница

OEM.

CP_MACCP

Текущая кодовая страница

Macintosh.

Примечание: Это значение

преимущественно

используется в ранее

созданных программных

кодах и теперь в нем нет

необходимости, так как

современные компьютеры

Macintosh используют Unicode

кодировку.

CP_THREAD_ACP

Кодировка Windows ANSI для

текущего потока выполнения.

CP_SYMBOL

Кодовая страница Symbol

CP_UTF7

65000

Кодовая страница UTF-7.

CP_UTF8

65001

Кодовая страница UTF-8.

Смотри также

Состояние клиентского терминала

Стандартные константы, перечисления и структуры

334

Константы диалогового окна MessageBox

Коды возврата функции MessageBox(). Если окно сообщения имеет кнопку Отмена (Cancel), то

функция возвращает значение IDCANCEL при нажатой клавише ESC или кнопке Отмена (Cancel).

Если окно сообщения не имеет кнопки Отмена (Cancel), нажатие ESC не дает никакого эффекта.

Константа

Значение

Описание

IDOK

Выбрана кнопка OK

IDCANCEL

Выбрана кнопка Отмена

(Cancel)

IDABORT

Выбрана кнопка Прервать

(Abort)

IDRETRY

Выбрана кнопка Повтор

(Retry)

IDIGNORE

Выбрана кнопка Пропустить

(Ignore)

IDYES

Выбрана кнопка Да (Yes)

IDNO

Выбрана кнопка Нет (No)

IDTRYAGAIN

Выбрана кнопка Повторить

(Try Again)

IDCONTINUE

Выбрана кнопка Продолжить

(Continue)

Основные флаги функции MessageBox() определяют содержание и поведение диалогового окна.

Это значение может быть комбинацией флагов из следующих групп флагов:

Константа

Значение

Описание

MB_OK

0x00000000

Окно сообщения содержит

одну кнопку: OK. По

умолчанию

MB_OKCANCEL

0x00000001

Окно сообщения содержит

две кнопки: OK и Cancel

MB_ABORTRETRYIGNORE

0x00000002

Окно сообщения содержит

три кнопки: Abort, Retry и

Ignore

MB_YESNOCANCEL

0x00000003

Окно сообщения содержит

три кнопки: Yes, No и Cancel

MB_YESNO

0x00000004

Окно сообщения содержит

две кнопки: Yes и No

Стандартные константы, перечисления и структуры

335

MB_RETRYCANCEL

0x00000005

Окно сообщения содержит

две кнопки: Retry и Cancel

MB_CANCELTRYCONTINUE

0x00000006

Окно сообщения содержит

три кнопки: Cancel, Try

Again, Continue

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

Константа

Значение

Описание

MB_ICONSTOP,

MB_ICONERROR,

MB_ICONHAND

0x00000010

Изображение знака STOP

MB_ICONQUESTION

0x00000020

Изображение

вопросительного знака

MB_ICONEXCLAMATION,

MB_ICONWARNING

0x00000030

Изображение

восклицательного знака

MB_ICONINFORMATION,

MB_ICONASTERISK

0x00000040

Изображение, состоящее из

строчного знака i в круге

Кнопки по умолчанию задаются следующими флагами:

Константа

Значение

Описание

MB_DEFBUTTON1

0x00000000

Первая кнопка

MB_DEFBUTTON1 - кнопка

выбрана по умолчанию, если

MB_DEFBUTTON2,

MB_DEFBUTTON3, или

MB_DEFBUTTON4 не

определены

MB_DEFBUTTON2

0x00000100

Вторая кнопка - кнопка по

умолчанию

MB_DEFBUTTON3

0x00000200

Третья кнопка - кнопка по

умолчанию

MB_DEFBUTTON4

0x00000300

Четвертая кнопка - кнопка по

умолчанию

Программы MQL5

336

Программы MQL5

Для того, чтобы mql5-программа могла работать, она должна быть скомпилирована (кнопка

"Компилировать" или клавиша F7). Компиляция должна пройти без ошибок (допускаются

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

директории, terminal_dir\MQL5\Experts, terminal_dir\MQL5\indicators или terminal_dir\MQL5

\scripts, должен быть создан выполняемый файл с тем же именем и расширением EX5. Именно

этот файл может быть запущен на выполнение.

Особенности работы mql5-программ описаны в разделах:

Выполнение программ – порядок вызова предопределенных функций-обработчиков событий;

События клиентского терминала – описание событий, которые можно обрабатывать в

программах;

Вызов импортируемых функций – порядок описания, допустимые параметры, порядок поиска и

соглашения о связях импортируемых функций;

Ошибки выполнения – получение информации об ошибках выполнения и критические ошибки.

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

графиков путем перетаскивания мышью из окна "Навигатор" клиентского терминала на

соответствующий график (технология Drag'n'Drop). mql5-программы могут работать только при

включенном клиентском терминале.

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

выбора "Советники - Удалить" из контекстного меню графика. На работу советника также влияет

состояние кнопки "Разрешить/запретить советников".

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

графика.

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

графика; информация о прикрепленных советниках и пользовательских индикаторах сохраняется

между запусками клиентского терминала.

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

по закрытию или изменению состояния текущего графика, либо по завершению работы

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

так как информация о них не сохраняется.

На одном графике могут работать максимум по одному эксперту и скрипту и неограниченное

количество индикаторов.

Программы MQL5

337

Выполнение программ

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

терминала и инициализация глобальных переменных. Если какая-либо глобальная переменная

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

глобальных переменных.

После этого программа находится в состоянии ожидания события от клиентского терминала. У

каждой mql5-программы должна быть хотя бы одна функция-обработчик события, в противном

случае загруженная программа выполняться не будет. Функции-обработчики событий имеют

предопределенные имена, предопределенные наборы параметров и предопределенные типы

возврата.

Тип

Имя функции

Параметры

Применение

Примечание

int

OnInit

нет

эксперты и

индикаторы

Обработчик

события Init.

Допускается тип

возвращаемого

значения void.

void

OnDeinit

const int reason

эксперты и

индикаторы

Обработчик

события Deinit.

void

OnStart

нет

скрипты

Обработчик

события Start.

int

OnCalculate

const int

rates_total,

const int

prev_calculated,

const datetime

&Time[],

const double

&Open[],

const double

&High[],

const double

&Low[],

const double

&Close[],

const long

&TickVolume[],

const long

&Volume[],

const int

&Spread[]

индикаторы

Обработчик

события

Calculate на всех

ценовых

данных.

int

OnCalculate

const int

rates_total,

const int

prev_calculated,

индикаторы

Обработчик

события

Calculate на

одном массиве

Программы MQL5

338

const int begin,

const double

&price[]

данных.

В индикаторе не

может

одновременно

присутствовать

2 обработчика

Calculate. В этом

случае будет

работать только

обработчик

события

Calculate на

одном массиве

данных.

void

OnTick

нет

эксперты

Обработчик

события NewTick

. Пока идет

обработка

события

прихода нового

тика другие

события этого

типа не

приходят.

void

OnTimer

нет

эксперты и

индикаторы

Обработчик

события Timer.

void

OnTrade

нет

эксперты

Обработчик

события Trade.

double

OnTester

нет

эксперты

Обработчики

события Tester

void

OnChartEvent

const int id,

const long

&lparam,

const double

&dparam,

const string

&sparam

эксперты и

индикаторы

Обработчик

события

ChartEvent.

void

OnBookEvent

const string

&symbol_name

эксперты

Обработчик

события

BookEvent.

Все возникающие события клиентский терминал складывает в общую очередь. Таким образом

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

NewTick. Если в очереди уже есть такое событие либо это событие находится в состоянии

обработки, то новое событие NewTick в очередь не ставится.

Очередь событий имеет ограниченный размер. При переполнении очереди старые события

Программы MQL5

339

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

Поэтому крайне рекомендуется писать эффективные обработчики событий и не рекомендуется

использовать бесконечные циклы (исключение составляют скрипты, которые обрабатывают одно

единственное событие Start).

Библиотеки не обрабатывают никаких событий.

Загрузка и выгрузка индикаторов

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

прикрепление индикатора к графику;

запуск терминала (если индикатор был прикреплен к графику перед предыдущим закрытием

терминала);

загрузка шаблона (если в шаблоне указан прикрепленный к графику индикатор);

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

смена символа и/или периода графика, к которому прикреплен индикатор;

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

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

Индикаторы выгружаются в следующих случаях:

при откреплении индикатора от графика;

закрытие терминала (если индикатор был прикреплен к графику);

загрузка шаблона, если к графику прикреплен индикатор;

закрытие графика, к которому был прикреплен индикатор;

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

смена символа и/или периода графика, к которому прикреплен индикатор;

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

Загрузка и выгрузка экспертов

Загрузка эксперта производится в следующих случаях:

прикрепление эксперта к графику;

запуск терминала (если эксперт был прикреплен к графику перед предыдущим закрытием

терминала);

загрузка шаблона (если в шаблоне указан прикрепленный к графику эксперт);

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

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

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

графику перед авторизацией терминала на сервере).

Выгрузка эксперта, прикрепленного к графику, производится в следующих случаях:

при откреплении эксперта от графика;

при прикреплении эксперта к графику – если на данном графике был уже другой эксперт, то этот

эксперт выгружается;

Программы MQL5

340

закрытие терминала (если эксперт был прикреплен к графику);

загрузка шаблона, если к графику прикреплен эксперт;

закрытие графика, к которому был прикреплен эксперт;

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

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

авторизацией терминала на сервере).

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

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

OnDeinit() на старом символе/таймфрейме и OnInit() на новом символе/таймфрейме (если они

есть), значения глобальных переменных и статических переменных не сбрасываются. Все

события, поступившие для эксперта до завершения инициализации (функции OnInit())

пропускаются.

Загрузка и выгрузка скриптов

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

своей работы. При этом функции OnInit() и OnDeinit() для скриптов не вызываются.

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

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

означает освобождение переменных типа string, освобождение объектовдинамическихмассивов

и вызов деструкторов при их наличии.

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

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

символа, таймфрейма и так далее:

Пример: