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

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

Пользовательские индикаторы

741

//| 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[])

{

static int ticks=0;

//--- считаем тики для изменения стиля, цвета и толщины линии

ticks++;

//--- если накопилось критическое число тиков

if(ticks>=N)

{

//--- меняем свойства линии

ChangeLineAppearance();

//--- сбрасываем счетчик тиков в ноль

ticks=0;

}

//--- вычисления значений индикатора

int start=0;

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

MqlDateTime dt;

//--- если расчет уже производился на предыдущем запуске OnCalculate

if(prev_calculated>0) start=prev_calculated-1; // установим начало расчетов с предпоследнего бара

//--- заполняем индикаторный буфер значениями

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

{

TimeToStruct(time[i],dt);

if(dt.day_of_week==invisible_day)

{

Histogram_2Buffer1[i]=0;

Histogram_2Buffer2[i]=0;

}

else

{

Histogram_2Buffer1[i]=open[i];

Histogram_2Buffer2[i]=close[i];

}

//--- вернем значение prev_calculated для следующего вызова функции

return(rates_total);

Пользовательские индикаторы

742

}

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

//| изменяет внешний вид линий в индикаторе |

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

void ChangeLineAppearance()

{

//--- строка для формирования информации о свойствах линии

string comm="";

//--- блок изменения цвета линии

int number=MathRand(); // получим случайное число

//--- делитель числа равен размеру массива colors[]

int size=ArraySize(colors);

//--- получим индекс для выбора нового цвета как остаток от целочисленного деления

int color_index=number%size;

//--- установим цвет как свойство PLOT_LINE_COLOR

PlotIndexSetInteger(0,PLOT_LINE_COLOR,colors[color_index]);

//--- запишем цвет линии

comm=comm+"\r\n"+(string)colors[color_index];

//--- блок изменения толщины линии

number=MathRand();

//--- получим толщину как остаток от целочисленного деления

int width=number%5; // толщина задается от о до 4

//--- установим толщину линий

PlotIndexSetInteger(0,PLOT_LINE_WIDTH,width);

//--- запишем толщину линии

comm=comm+"\r\nWidth="+IntegerToString(width);

//--- блок изменения стиля линии

number=MathRand();

//--- делитель числа равен размеру массива styles

size=ArraySize(styles);

//--- получим индекс для выбора нового стиля как остаток от целочисленного деления

int style_index=number%size;

//--- установим стиль линий

PlotIndexSetInteger(0,PLOT_LINE_STYLE,styles[style_index]);

//--- запишем стиль линии

comm="\r\n"+EnumToString(styles[style_index])+""+comm;

//--- добавим информацию о дне, который пропускается в расчетах

comm="\r\nНеотрисовываемый день - "+EnumToString((ENUM_DAY_OF_WEEK)invisible_day)+comm;

//--- выведем информацию на график через комментарий

Comment(comm);

}

Пользовательские индикаторы

743

DRAW_ARROW

Стиль DRAW_ARROW рисует на графике заданным цветом стрелки (символы из набора Wingdings)

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

стиля DRAW_LINE – директивами компилятора или динамически с помощью функции

PlotIndexSetInteger(). Динамическое изменение свойств графического построения позволяет

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

Код символа для вывода на график задается с помощью свойства PLOT_ARROW.

//--- зададим код символа из шрифта Wingdings для отрисовки в PLOT_ARROW

PlotIndexSetInteger(0,PLOT_ARROW,code);

По умолчанию значение PLOT_ARROW=159 (кружок).

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

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

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

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

смещены по вертикали, хотя сами значения индикатора останутся те же самые:

//--- зададим cмещение стрелок по вертикали в пикселях

PlotIndexSetInteger(0,PLOT_ARROW_SHIFT,shift);

Отрицательное значение PLOT_ARROW_SHIFT означает смещение стрелок вверх, положительно

значения смещает стрелки вниз.

Стиль DRAW_ARROW можно использовать как в отдельном подокне графика, так и в главном

окне. Пустые значения не отрисовываются и не отображаются в "Окне данных", все значения в

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

значением не производится.

//--- установим пустое значение

PlotIndexSetDouble(индекс_построения_DRAW_ARROW,PLOT_EMPTY_VALUE,0);

Количество требуемых буферов для построения DRAW_ARROW — 1.

Пример индикатора, рисующего стрелки на каждом баре, у которого цена закрытия Close больше

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

меняются случайным образом каждые N тиков.

Пользовательские индикаторы

744

В примере первоначально для графического построения plot1 со стилем DRAW_ARROW свойства,

цвет и размер задаются с помощью директивы компилятора #property, а затем в функции

OnCalculate() свойства задаются случайным образом. Параметр N вынесен во внешние параметры

индикатора для возможности ручной установки (закладка "Параметры" в окне свойств

индикатора).

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

//| DRAW_ARROW.mq5 |

//| http://www.mql5.com |

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

#property link "http://www.mql5.com"

#property version "1.00"

#property description "Индикатор для демонстрации DRAW_ARROW"

#property description "Рисует на графике стрелки, задаваемые символами Unicode"

#property description "Цвет, размер, смещение и код символа стрелки меняется случайным образом"

#property description "через каждые N тиков"

#property description "Параметр code задает базовое значение: код=159 (кружок)"

#property indicator_chart_window

#property indicator_buffers 1

#property indicator_plots 1

//--- plot Arrows

#property indicator_label1 "Arrows"

#property indicator_type1 DRAW_ARROW

#property indicator_color1 clrGreen

#property indicator_width1 1

//--- input параметры

Пользовательские индикаторы

745

input int N=5; // кол-во тиков для изменения

input ushort code=159; // код символа для отрисовки в DRAW_ARROW

//--- индикаторный буфер для построения

double ArrowsBuffer[];

//--- массив для хранения цветов

color colors[]={clrRed,clrBlue,clrGreen};

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

//| Custom indicator initialization function |

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

int OnInit()

{

//--- indicator buffers mapping

SetIndexBuffer(0,ArrowsBuffer,INDICATOR_DATA);

//--- зададим код символа для отрисовки в PLOT_ARROW

PlotIndexSetInteger(0,PLOT_ARROW,code);

//--- зададим cмещение стрелок по вертикали в пикселях

PlotIndexSetInteger(0,PLOT_ARROW_SHIFT,5);

//--- установим в качестве пустого значения 0

PlotIndexSetDouble(0,PLOT_EMPTY_VALUE,0);

//---

return(0);

}

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

//| 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[])

{

static int ticks=0;

//--- считаем тики для изменения цвета, размера, смешения и кода стрелки

ticks++;

//--- если накопилось критическое число тиков

if(ticks>=N)

{

//--- меняем свойства линии

ChangeLineAppearance();

//--- сбрасываем счетчик тиков в ноль

ticks=0;

}

Пользовательские индикаторы

746

//--- блок расчета значений индикатора

int start=1;

if(prev_calculated>0) start=prev_calculated-1;

//--- цикл расчета

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

{

//--- если текущая цена Close больше предыдущей, ставим стрелку

if(close[i]>close[i-1])

ArrowsBuffer[i]=close[i];

//--- в противном случае указываем нулевое значение

else

ArrowsBuffer[i]=0;

}

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

return(rates_total);

}

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

//| изменяет внешний вид символов в индикаторе |

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

void ChangeLineAppearance()

{

//--- строка для формирования информации о свойствах индикатора

string comm="";

//--- блок изменения цвета cтрелки

int number=MathRand(); // получим случайное число

//--- делитель числа равен размеру массива colors[]

int size=ArraySize(colors);

//--- получим индекс для выбора нового цвета как остаток от целочисленного деления

int color_index=number%size;

//--- установим цвет как свойство PLOT_LINE_COLOR

PlotIndexSetInteger(0,PLOT_LINE_COLOR,colors[color_index]);

//--- запишем цвет линии

comm=comm+"\r\n"+(string)colors[color_index];

//--- блок изменения размера стрелок

number=MathRand();

//--- получим толщину как остаток от целочисленного деления

int width=number%5; // размер задается от о до 4

//--- установим цвет как свойство PLOT_LINE_WIDTH

PlotIndexSetInteger(0,PLOT_LINE_WIDTH,width);

//--- запишем размер стрелок

comm=comm+"\r\nWidth="+IntegerToString(width);

//--- блок изменения кода стрелки (PLOT_ARROW)

number=MathRand();

//--- получим остаток от целочисленного деления для вычисления нового кода стрелки (от 0 до 19)

int code_add=number%20;

//--- установим новый код символа как сумму code+code_add

Пользовательские индикаторы

747

PlotIndexSetInteger(0,PLOT_ARROW,code+code_add);

//--- запишем код символа PLOT_ARROW

comm="\r\n"+"PLOT_ARROW="+IntegerToString(code+code_add)+comm;

//--- блок изменения смещения стрелок по вертикали в пикселях

number=MathRand();

//--- получим смещение как остаток от целочисленного деления

int shift=20-number%41;

//--- установим новое смещение от -20 до 20

PlotIndexSetInteger(0,PLOT_ARROW_SHIFT,shift);

//--- запишем смещение PLOT_ARROW_SHIFT

comm="\r\n"+"PLOT_ARROW_SHIFT="+IntegerToString(shift)+comm;

//--- выведем информацию на график через комментарий

Comment(comm);

}

Пользовательские индикаторы

748

DRAW_ZIGZAG

Стиль DRAW_ZIGZAG рисует заданным цветом отрезки по значениям двух индикаторных буферов.

Этот стиль очень похож на DRAW_SECTION, но в отличие от последнего позволяет рисовать

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

индикаторных буферов. Отрезки рисуются от значения в первом буфере до значения во втором

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

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

Толщину, цвет и стиль отображения линии можно задавать так же, как и для стиля

DRAW_SECTION – директивами компилятора или динамически с помощью функции

PlotIndexSetInteger(). Динамическое изменение свойств графического построения позволяет

"оживить" индикаторы, чтобы они меняли свой вид в зависимости от текущей ситуации.

Секции рисуются от одного непустого значения одного буфера до непустого значения другого

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

значение в свойстве PLOT_EMPTY_VALUE:

//--- значение 0 (пустое значение) не будет участвовать в отрисовке

PlotIndexSetDouble(индекс_построения_DRAW_ZIGZAG,PLOT_EMPTY_VALUE,0);

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

буфере пустое значение.

Количество требуемых буферов для построения DRAW_ZIGZAG — 2.

Пример индикатора, рисующего пилу по ценам High и Low. Цвет, толщина и стиль линий зигзага

меняются случайным образом каждые N тиков.

Обратите внимание, первоначально для графического построения plot1 со стилем DRAW_ZIGZAG

свойства задаются с помощью директивы компилятора #property, а затем в функции OnCalculate()

эти три свойства задаются случайным образом. Параметр N вынесен во внешние параметры

Пользовательские индикаторы

749

индикатора для возможности ручной установки (закладка "Параметры" в окне свойств

индикатора).

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

//| DRAW_ZIGZAG.mq5 |

//| http://www.mql5.com |

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

#property link "http://www.mql5.com"

#property version "1.00"

#property description "Индикатор для демонстрации DRAW_ZIGZAG"

#property description "Рисует прямыми отрезками \"пилу\", пропуская бары одного дня"

#property description "День пропусков выбирается случайным образом при запуске индикатора"

#property description "Цвет, толщина и стиль отрезков меняется случайным"

#property description " образом через каждые N тиков"

#property indicator_separate_window

#property indicator_buffers 2

#property indicator_plots 1

//--- plot ZigZag

#property indicator_label1 "ZigZag"

#property indicator_type1 DRAW_ZIGZAG

#property indicator_color1 clrBlue

#property indicator_style1 STYLE_SOLID

#property indicator_width1 1

//--- input параметры

input int N=5; // кол-во тиков для изменения

//--- indicator buffers

double ZigZagBuffer1[];

double ZigZagBuffer2[];

//--- день недели, для которого индикатор не рисуется

int invisible_day;

//--- массив для хранения цветов

color colors[]={clrRed,clrBlue,clrGreen};

//--- массив для хранения стилей отрисовки линии

ENUM_LINE_STYLE styles[]={STYLE_SOLID,STYLE_DASH,STYLE_DOT,STYLE_DASHDOT,STYLE_DASHDOTDOT};

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

//| Custom indicator initialization function |

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

int OnInit()

{

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

SetIndexBuffer(0,ZigZagBuffer1,INDICATOR_DATA);

SetIndexBuffer(1,ZigZagBuffer2,INDICATOR_DATA);

//--- получим случайное число от 0 до 6, для этого дня индикатор не рисуется

invisible_day=MathRand()%6;

//--- значение 0 (пустое значение) не будет участвовать в отрисовке

Пользовательские индикаторы

750

PlotIndexSetDouble(0,PLOT_EMPTY_VALUE,0);

//--- значение 0 (пустое значение) не будет участвовать в отрисовке

PlotIndexSetString(0,PLOT_LABEL,"ZigZag1;ZigZag2");

//---

return(0);

}

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

//| 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[])

{

static int ticks=0;

//--- считаем тики для изменения стиля, цвета и толщины линии

ticks++;

//--- если накопилось достаточное число тиков

if(ticks>=N)

{

//--- меняем свойства линии

ChangeLineAppearance();

//--- сбрасываем счетчик тиков в ноль

ticks=0;

}

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

MqlDateTime dt;

//--- позиция начала расчетов

int start=0;

//--- если индикатор рассчитывался на предыдущем тике, то начинаем расчет с предпоследнего

if(prev_calculated!=0) start=prev_calculated-1;

//--- цикл расчетов

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

{

//--- запишем время открытия бара в структуру

TimeToStruct(time[i],dt);

//--- если день недели этого бара равен invisible_day

if(dt.day_of_week==invisible_day)

{

//--- запишем пустые значения в буферы для этого бара