Включаемый файл указывается с помощью ключевого слова #include, после которого следует путь к включаемому файлу.
Включаемый файл – это часто используемый блок кода. Такие файлы могут включаться в исходные тексты экспертов, скриптов, пользовательских индикаторов и библиотек на этапе компиляции. Использование включаемых файлов более предпочтительно, чем использование библиотек, из-за дополнительных накладных расходов при вызове библиотечных функций.
Включаемые файлы могут находиться в той же директории, что и исходный файл, в этом случае используется директива #include с двойными кавычками. Другое место хранения включаемых файлов – в директории <каталог_терминала>\MQL5\Include, в этом случае используется директива #include с угловыми скобками.
В качестве первого свойства индикатора, как правило, указывается имя разработчика, например:
#property copyright
Далее указывается ссылка на сайт разработчика:
#property link
После этого идет описание индикатора, каждая строка которого обозначается с помощью идентификатора description, например:
#property description "Average Directional Movement Index"
Далее указывается версия индикатора:
#property version "1.00"
На этом, как правило, объявление общих свойств индикатора заканчивается.
Индикатор может появляться в окне терминала двумя способами – на графике символа или в отдельном окне под графиком символа.
Свойство:
#property indicator_chart_window
Определяет отрисовку индикатора на графике символа.
А свойство:
#property indicator_separate_window
Определяет вывод индикатора в отдельное окно.
Одно из самых важных свойств индикатора – это количество буферов для расчета индикатора, например:
#property indicator_buffers 6
Данное свойство тесно связано с двумя другими свойствами индикатора – количеством графических построений и видом графических построений.
Количество графических построений – это количество цветных диаграмм, составляющих индикатор.
Например, для индикатора ADX:
#property indicator_plots 3
Индикатор состоит из трех диаграмм (линий) – индикатора направленности +DI, индикатора направленности –DI и самого индикатора ADX.
Вид графических построений – это та графическая форма, из которой составляется график индикатора.
Например, для индикатора ADX:
#property indicator_type1 DRAW_LINE
#property indicator_type2 DRAW_LINE
#property indicator_type3 DRAW_LINE
Таким образом, каждая диаграмма индикатора ADX – это линия.
Графическая форма сопоставляется с графическим построением с помощью номера графического построения, следующего после indicator_type.
Цвет каждого графического построения индикатора задается свойством indicator_colorN.
Например, для индикатора ADX:
#property indicator_color1 LightSeaGreen
#property indicator_color2 YellowGreen
#property indicator_color3 Wheat
Цвет сопоставляется с графическим построением с помощью номера графического построения, следующего после indicator_color.
В справочнике MQL5 есть таблица Web-цветов для определения цвета графического построения.
Вернемся теперь к количеству буферов для расчета индикатора.
Так как данные для построения каждой диаграммы индикатора берутся из своего буфера индикатора, количество заявленных буферов индикатора не может быть меньше, чем заявленное число графических построений индикатора.
Сразу же возникает вопрос, каким образом конкретный массив, представляющий буфер индикатора, сопоставляется с конкретным графическим построением индикатора.
Делается это в функции обратного вызова OnInit() с помощью вызова функции SetIndexBuffer.
Например, для индикатора ADX:
SetIndexBuffer(0,ExtADXBuffer);
SetIndexBuffer(1,ExtPDIBuffer);
SetIndexBuffer(2,ExtNDIBuffer);
Где первый аргумент, это номер графического построения.
Таким образом, массив связывается с диаграммой индикатора, а диаграмма связывается с ее формой и цветом.
Однако с буферами индикатора все немного сложнее.
Их количество может быть заявлено больше, чем количество графических построений индикатора.
Что это означает?
Это означает, что некоторые массивы, представляющие буфера индикатора, используются не для построения диаграмм индикатора, а для промежуточных вычислений.
Например, для индикатора ADX:
SetIndexBuffer(3,ExtPDBuffer,INDICATOR_CALCULATIONS);
SetIndexBuffer(4,ExtNDBuffer,INDICATOR_CALCULATIONS);
SetIndexBuffer(5,ExtTmpBuffer,INDICATOR_CALCULATIONS);
Такой массив определяется с помощью третьего параметра INDICATOR_CALCULATIONS.
Это дает следующее:
Все дело в частичном заполнении массива.
Если массив, указанный в функции SetIndexBuffer, является динамическим, т.е. объявлен без указания размера, но он привязан к буферу индикатора с помощью функции SetIndexBuffer, клиентский терминал сам заботится о том, чтобы размер такого массива соответствовал ценовой истории.
Рассмотрим это на примере индикатора ADX.
В редакторе MQL5, в окне Navigator (Навигатор), в разделе Indicators->Examples выберем и откроем исходный код индикатора ADX.
В функции OnInit() закомментируем строку:
// SetIndexBuffer(5,ExtTmpBuffer,INDICATOR_CALCULATIONS);
Теперь массив ExtTmpBuffer является просто динамическим массивом.
Откомпилируем код индикатора и присоединим индикатор к графику в терминале MetaTrader 5.
В результате Терминал выдаст ошибку.
array out of range
Это произошло потому, что мы перед заполнением данного массива значениями не указали его размера и не зарезервировали под него память.
Так что его размер был равен нулю, когда мы попытались в него что-то записать.
Статическим мы этот массив сделать тоже не можем, т.е. объявить его сразу с указанием размера, так как значения такого промежуточного массива рассчитываются в функции обратного вызова OnCalculate на основе загруженной в функцию OnCalculate истории цен, а именно массивов open[], high[], low[], и close[].
Но точный размер массивов open[], high[], low[], и close[] неизвестен, он обозначается лишь переменной rates_total.
Хорошо, но мы можем в функции OnCalculate применить функцию ArrayResize, чтобы установить размер массива:
ArrayResize(ExtTmpBuffer,rates_total);
Передав в функцию в качестве аргумента переменную rates_total – количество баров на графике, на котором запущен индикатор.
Теперь после компиляции индикатор заработает как надо.
Но дело в том, что в функции OnCalculate мы сначала рассчитываем индикатор для всей ценовой истории, т.е. для rates_total значений, а затем при поступлении нового тика по символу индикатора, и соответственно вызове функции OnCalculate, мы рассчитываем значение индикатора для этого нового тика по символу и записываем новое значение индикатора в его массив буфера.
Чтобы это реализовать с промежуточным массивом, нужно внимательно следить за его размером и записывать новое значение в конец массива.
Вместо всего этого, проще всего привязать промежуточный массив к буферу индикатора с помощью функции SetIndexBuffer и таким образом решить все эти проблемы.
