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

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

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

231

Методы скользящих

В основе многих технических индикаторов лежат те или иные методы сглаживания ценовых

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

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

перечисленные в перечислении ENUM_MA_METHOD.

ENUM_MA_METHOD

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

Описание

MODE_SMA

Простое усреднение

MODE_EMA

Экспоненциальное усреднение

MODE_SMMA

Сглаженное усреднение

MODE_LWMA

Линейно-взвешенное усреднение

Пример:

double ExtJaws[];

double ExtTeeth[];

double ExtLips[];

//---- handles for moving averages

int ExtJawsHandle;

int ExtTeethHandle;

int ExtLipsHandle;

//--- get MA's handles

ExtJawsHandle=iMA(NULL,0,JawsPeriod,0,MODE_SMMA,PRICE_MEDIAN);

ExtTeethHandle=iMA(NULL,0,TeethPeriod,0,MODE_SMMA,PRICE_MEDIAN);

ExtLipsHandle=iMA(NULL,0,LipsPeriod,0,MODE_SMMA,PRICE_MEDIAN);

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

232

Линии индикаторов

Некоторые техническиеиндикаторы имеют несколько отрисовываемых на графике буферов.

Нумерация индикаторных буферов начинается с 0. При копировании значений индикатора

функцией CopyBuffer() в массив типа double для некоторых индикаторов можно указывать не

номер копируемого буфера, а идентификатор этого буфера.

Идентификаторы линий индикаторов, допустимых при копировании значений индикаторов iMACD

(), iRVI() и iStochastic()

Константа

Значение

Описание

MAIN_LINE

Основная линия

SIGNAL_LINE

Сигнальная линия

Идентификаторы линий индикаторов, допустимых при копировании значений индикаторов ADX() и

ADXW()

Константа

Значение

Описание

MAIN_LINE

Основная линия

PLUSDI_LINE

Линия +DI

MINUSDI_LINE

Линия –DI

Идентификаторы линий индикаторов допустимых при копировании значений индикатора iBands()

Константа

Значение

Описание

BASE_LINE

Основная линия

UPPER_BAND

Верхняя граница

LOWER_BAND

Нижняя граница

Идентификаторы линий индикаторов, допустимых при копировании значений индикаторов

iEnvelopes() и iFractals()

Константа

Значение

Описание

UPPER_LINE

Верхняя линия

LOWER_LINE

Нижняя линия

Идентификаторы линий индикаторов, допустимых при копировании значений индикатора iGator()

Константа

Значение

Описание

UPPER_HISTOGRAM

Верхняя гистограмма

LOWER_HISTOGRAM

Нижняя гистограмма

Идентификаторы линий индикаторов, допустимых при копировании значений индикатора iAlligator

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

233

()

Константа

Значение

Описание

GATORJAW_LINE

Линия челюстей

GATORTEETH_LINE

Линия зубов

GATORLIPS_LINE

Линия губ

Идентификаторы линий индикаторов, допустимых при копировании значений индикатора

iIchimoku()

Константа

Значение

Описание

TENKANSEN_LINE

Линия Tenkan-sen

KIJUNSEN_LINE

Линия Kijun-sen

SENKOUSPANA_LINE

Линия Senkou Span A

SENKOUSPANB_LINE

Линия Senkou Span B

CHINKOUSPAN_LINE

Линия Chinkou Span

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

234

Стили рисования

При создании пользовательскогоиндикатора можно указать один из 18 типов графического

построения (способа отображения на главном окне графика или в подокне графика), значения

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

В одном пользовательском индикаторе допустимо использовать любые виды построения/

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

массивов для хранения данных, необходимых для рисования. Эти массивы данных необходимо

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

буфера тип данных из перечисления ENUM_INDEXBUFFER_TYPE.

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

(отмеченных как INDICATOR_DATA), а если стиль допускает динамическое чередование цвета (все

стили со словом COLOR в наименовании), то необходим и один буфер цвета (указан тип

INDICATOR_COLOR_INDEX). Цветовой буфер всегда связывается сразу после соответствующих

стилю буферов значений.

ENUM_DRAW_TYPE

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

Описание

Буферов значений

Буферов цвета

DRAW_NONE

Не отрисовывается

DRAW_LINE

Линия

DRAW_SECTION

Отрезки

DRAW_HISTOGRAM

Гистограмма от

нулевой линии

DRAW_HISTOGRAM2

Гистограмма на двух

индикаторных

буферах

DRAW_ARROW

Отрисовка стрелками

DRAW_ZIGZAG

Стиль Zigzag

допускает

вертикальные

отрезки на баре

DRAW_FILLING

Цветовая заливка

между двумя

уровнями

DRAW_BARS

Отображение в виде

баров

DRAW_CANDLES

Отображение в виде

свечей

DRAW_COLOR_LINE

Разноцветная линия

DRAW_COLOR_SECTIO

Разноцветные

отрезки

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

235

DRAW_COLOR_HISTO

GRAM

Разноцветная

гистограмма от

нулевой линии

DRAW_COLOR_HISTO

GRAM2

Разноцветная

гистограмма на двух

индикаторных

буферах

DRAW_COLOR_ARRO

Отрисовка

разноцветными

стрелками

DRAW_COLOR_ZIGZAG

Разноцветный ZigZag

DRAW_COLOR_BARS

Разноцветные бары

DRAW_COLOR_CANDL

Разноцветные свечи

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

перечисленные в перечислениях ENUM_PLOT_PROPERTY.

Для функций PlotIndexSetInteger() и PlotIndexGetInteger()

ENUM_PLOT_PROPERTY_INTEGER

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

Описание

Тип свойства

PLOT_ARROW

Код стрелки для стиля

DRAW_ARROW

uchar

PLOT_ARROW_SHIFT

Смещение стрелок по

вертикали для стиля

DRAW_ARROW

int

PLOT_DRAW_BEGIN

Количество начальных баров

без отрисовки и значений в

DataWindow

int

PLOT_DRAW_TYPE

Тип графического

построения

ENUM_DRAW_TYPE

PLOT_SHOW_DATA

Признак отображения

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

DataWindow

bool

PLOT_SHIFT

Сдвиг графического

построения индикатора по

оси времени в барах

int

PLOT_LINE_STYLE

Стиль линии отрисовки

ENUM_LINE_STYLE

PLOT_LINE_WIDTH

Толщина линии отрисовки

int

PLOT_COLOR_INDEXES

Количество цветов

int

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

236

PLOT_LINE_COLOR

Индекс буфера,

содержащего цвет отрисовки

color модификатор=номер

индекса цвета

Для функции PlotIndexSetDouble()

ENUM_PLOT_PROPERTY_DOUBLE

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

Описание

Тип свойства

PLOT_EMPTY_VALUE

Пустое значение для

построения, для которого нет

отрисовки

double

Для функции PlotIndexSetString()

ENUM_PLOT_PROPERTY_STRING

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

Описание

Тип свойства

PLOT_LABEL

Имя индикаторной

графической серии для

отображения в окне

DataWindow

string

Существуют 5 стилей, которыми может рисоваться линия в пользовательском индикаторе. Они

применимы только при толщине линии 0 или 1.

ENUM_LINE_STYLE

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

Описание

STYLE_SOLID

Сплошная линия

STYLE_DASH

Прерывистая линия

STYLE_DOT

Пунктирная линия

STYLE_DASHDOT

Штрих-пунктирная линия

STYLE_DASHDOTDOT

Штрих - две точки

Для задания стиля рисования линии и вида отрисовки используется функция PlotIndexSetInteger().

Для расширений Фибоначчи указать толщину и стиль отрисовки уровней можно функцией

ObjectSetInteger().

Пример:

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

237

#property indicator_chart_window

#property indicator_buffers 1

#property indicator_plots 1

//--- indicator buffers

double MABuffer[];

//+------------------------------------------------------------------+

//| Custom indicator initialization function |

//+------------------------------------------------------------------+

void OnInit()

{

//--- привязка массива к индикаторному буферу с индексом 0

SetIndexBuffer(0,MABuffer,INDICATOR_DATA);

//--- задать рисование линии

PlotIndexSetInteger(0,PLOT_DRAW_TYPE,DRAW_LINE);

//--- задание стиля для рисования линии

PlotIndexSetInteger(0,PLOT_LINE_STYLE,STYLE_DOT);

//--- задание цвета линии

PlotIndexSetInteger(0,PLOT_LINE_COLOR,clrRed);

//--- задание толщины линии

PlotIndexSetInteger(0,PLOT_LINE_WIDTH,1);

//--- задание метки для линии

PlotIndexSetString(0,PLOT_LABEL,"Moving Average");

//---

}

//+------------------------------------------------------------------+

//| Custom indicator iteration function |

//+------------------------------------------------------------------+

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 &tick_volume[],

const long &volume[],

const int &spread[])

{

//---

for(int i=prev_calculated;i<rates_total;i++)

{

MABuffer[i]=close[i];

}

//--- return value of prev_calculated for next call

return(rates_total);

}

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

238

Свойства пользовательских индикаторов

Количество индикаторных буферов, которые можно использовать в пользовательском

индикаторе, не ограничено. Но каждому массиву, который назначается в качестве индикаторного

буфера с помощью функции SetIndexBuffer(), должен быть указан тип данных, которые он будет

хранить. Это может быть одно из значений перечисления ENUM_INDEXBUFFER_TYPE.

ENUM_INDEXBUFFER_TYPE

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

Описание

INDICATOR_DATA

Данные для отрисовки

INDICATOR_COLOR_INDEX

Цвета отрисовки

INDICATOR_CALCULATIONS

Вспомогательные буфера для промежуточных

вычислений

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

Эти настройки производятся через задание соответствующих свойств индикатора с помощью

функций IndicatorSetDouble(), IndicatorSetInteger() и IndicatorSetString(). Идентификаторы свойств

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

ENUM_CUSTOMIND_PROPERTY_INTEGER

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

Описание

Тип свойства

INDICATOR_DIGITS

Точность отображения

значений индикатора

int

INDICATOR_HEIGHT

Фиксированная высота

собственного окна

индикатора (команда

препроцессора #property

indicator_height)

int

INDICATOR_LEVELS

Количество уровней на окне

индикатора

int

INDICATOR_LEVELCOLOR

Цвет линии уровня

color

модификатор=номер уровня

INDICATOR_LEVELSTYLE

Стиль линии уровня

ENUM_LINE_STYLE

модификатор=номер уровня

INDICATOR_LEVELWIDTH

Толщина линии уровня

int

модификатор=номер уровня

ENUM_CUSTOMIND_PROPERTY_DOUBLE

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

Описание

Тип свойства

INDICATOR_MINIMUM

Минимум окна индикатора

double

INDICATOR_MAXIMUM

Максимум окна индикатора

double

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

239

INDICATOR_LEVELVALUE

Значение уровня

double

модификатор=номер уровня

ENUM_CUSTOMIND_PROPERTY_STRING

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

Описание

Тип свойства

INDICATOR_SHORTNAME

Короткое наименование

индикатора

string

INDICATOR_LEVELTEXT

Описание уровня

string

модификатор=номер уровня

Примеры:

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

240

//--- indicator settings

#property indicator_separate_window

#property indicator_buffers 4

#property indicator_plots 2

#property indicator_type1 DRAW_LINE

#property indicator_type2 DRAW_LINE

#property indicator_color1 clrLightSeaGreen

#property indicator_color2 clrRed

//--- input parameters

extern int KPeriod=5;

extern int DPeriod=3;

extern int Slowing=3;

//--- indicator buffers

double MainBuffer[];

double SignalBuffer[];

double HighesBuffer[];

double LowesBuffer[];

//+------------------------------------------------------------------+

//| Custom indicator initialization function |

//+------------------------------------------------------------------+

void OnInit()

{

//--- indicator buffers mapping

SetIndexBuffer(0,MainBuffer,INDICATOR_DATA);

SetIndexBuffer(1,SignalBuffer,INDICATOR_DATA);

SetIndexBuffer(2,HighesBuffer,INDICATOR_CALCULATIONS);

SetIndexBuffer(3,LowesBuffer,INDICATOR_CALCULATIONS);

//--- set accuracy

IndicatorSetInteger(INDICATOR_DIGITS,2);

//--- set levels

IndicatorSetInteger(INDICATOR_LEVELS,2);

IndicatorSetDouble(INDICATOR_LEVELVALUE,0,20);

IndicatorSetDouble(INDICATOR_LEVELVALUE,1,80);

//--- set maximum and minimum for subwindow

IndicatorSetDouble(INDICATOR_MINIMUM,0);

IndicatorSetDouble(INDICATOR_MAXIMUM,100);

//--- sets first bar from what index will be drawn

PlotIndexSetInteger(0,PLOT_DRAW_BEGIN,KPeriod+Slowing-2);

PlotIndexSetInteger(1,PLOT_DRAW_BEGIN,KPeriod+Slowing+DPeriod);

//--- set style STYLE_DOT for second line

PlotIndexSetInteger(1,PLOT_LINE_STYLE,STYLE_DOT);

//--- name for DataWindow and indicator subwindow label

IndicatorSetString(INDICATOR_SHORTNAME,"Stoch("+KPeriod+","+DPeriod+","+Slowing+")");

PlotIndexSetString(0,PLOT_LABEL,"Main");

PlotIndexSetString(1,PLOT_LABEL,"Signal");

//--- sets drawing line empty value

PlotIndexSetDouble(0,PLOT_EMPTY_VALUE,0.0);

PlotIndexSetDouble(1,PLOT_EMPTY_VALUE,0.0);

//--- initialization done

}