Справочник MQL4 Возможности MQL5 Функции MQL5 Обработка событий

Обработка событий

В языке MQL5 предусмотрена обработка некоторых предопределенных событий. Функции для обработки этих событий должны быть определены в программе MQL5: имя функции, тип возвращаемого значения, состав параметров (если они есть) и их типы должны строго соответствовать описанию функции-обработчика события.

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

Функция	Описание
OnStart	Вызывается в скрипте при наступлении события Start для выполнения действий, заложенных в скрипт
OnInit	Вызывается в индикаторах и экспертах при наступлении события Init для инициализации запущенной MQL5-программы
OnDeinit	Вызывается в индикаторах и экспертах при наступлении события Deinit для деинициализации запущенной MQL5-программы
OnTick	Вызывается в экспертах при наступлении события NewTick для обработки новой котировки
OnCalculate	Вызывается в индикаторах при наступлении события Calculate для обработки изменения ценовых данных
OnTimer	Вызывается в индикаторах и экспертах при наступлении периодического события Timer, которое с заданным интервалом времени генерируется терминалом
OnTrade	Вызывается в экспертах при наступлении события Trade, которое генерируется при завершении торговой операции на торговом сервере
OnTradeTransaction	Вызывается в экспертах при наступлении события TradeTransaction для обработки результатов выполнения торгового запроса
OnBookEvent	Вызывается в экспертах при наступлении события BookEvent для обработки изменений в стаканe заявок
OnChartEvent	Вызывается в индикаторах и экспертах при наступлении события ChartEvent для обработки изменений графика, вызванных действиями пользователя или работой MQL5-программ
OnTester	Вызывается в экспертах при наступлении события Tester для выполнения необходимых действий по окончании тестирования
OnTesterInit	Вызывается в экспертах при наступлении события TesterInit для выполнения необходимых действий перед началом оптимизации
OnTesterDeinit	Вызывается в экспертах при наступлении события TesterDeinit для выполнения необходимых действий по окончании оптимизации эксперта
OnTesterPass	Вызывается в экспертах при наступлении события TesterPass для обработки поступления нового фрейма данных во время оптимизации эксперта

Клиентский терминал отсылает возникающие события в соответствующие открытые графики. Также события могут генерироваться графиками (события графика) либо mql5-программами (пользовательские события). Генерацию событий создания и удаления графических объектов на графике можно включать и отключать заданием свойств графика CHART_EVENT_OBJECT_CREATE и CHART_EVENT_OBJECT_DELETE. Каждая mql5-программа и каждый график имеют свою собственную очередь событий, куда складываются все вновь поступающие события.

Программа получает события только от графика, на котором она запущена. Все события обрабатываются одно за другим в порядке поступления. Если в очереди уже есть событие NewTick либо это событие находится в состоянии обработки, то новое событие NewTick в очередь mql5-программы не ставится. Аналогично, если в очереди mql5-программы уже находится событие ChartEvent или такое событие обрабатывается, то новое событие такого типа не ставится в очередь. Обработка событий таймера производится по такой же схеме – если в очереди находится или уже обрабатывается событие Timer, то новое событие таймера не ставится в очередь.

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

Крайне не рекомендуется использовать бесконечные циклы для обработки событий. Исключением из этого правила могут быть только скрипты, которые обрабатывают одно единственное событие Start.

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

Проверка состоянияПолучение рыночной информации