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

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

Технические индикаторы

901

iTriX

Возвращает хэндл индикатора Triple Exponential Moving Averages Oscillator. Всего один буфер.

int iTriX(

string symbol, // имя символа

ENUM_TIMEFRAMES period, // период

int ma_period, // период усреднения

ENUM_APPLIED_PRICE applied_price // тип цены или handle

);

Параметры

symbol

[in] Символьное имя инструмента, на данных которого будет вычисляться индикатор. NULL

означает текущий символ.

period

[in] Значение периода может быть одним из значений перечисления ENUM_TIMEFRAMES, 0

означает текущий таймфрейм.

ma_period

[in] Период(количество баров) для вычисления индикатора.

applied_price

[in] Используемая цена. Может быть любой из ценовых констант ENUM_APPLIED_PRICE или

хендлом другого индикатора.

Возвращаемое значение

Возвращает хэндл указанного технического индикатора, в случае неудачи возвращает

INVALID_HANDLE. Для освобождения памяти компьютера от неиспользуемого больше

индикатора служит функция IndicatorRelease(), которой передается хэндл этого индикатора.

Технические индикаторы

902

iWPR

Возвращает хэндл индикатора Larry Williams' Percent Range. Всего один буфер.

int iWPR(

string symbol, // имя символа

ENUM_TIMEFRAMES period, // период

int calc_period // период усреднения

);

Параметры

symbol

[in] Символьное имя инструмента, на данных которого будет вычисляться индикатор. NULL

означает текущий символ.

period

[in] Значение периода может быть одним из значений перечисления ENUM_TIMEFRAMES, 0

означает текущий таймфрейм.

calc_period

[in] Период(количество баров) для вычисления индикатора.

Возвращаемое значение

Возвращает хэндл указанного технического индикатора, в случае неудачи возвращает

INVALID_HANDLE. Для освобождения памяти компьютера от неиспользуемого больше

индикатора служит функция IndicatorRelease(), которой передается хэндл этого индикатора.

Технические индикаторы

903

iVIDyA

Возвращает хэндл индикатора Variable Index DYnamic Average. Всего один буфер.

int iVIDyA(

string symbol, // имя символа

ENUM_TIMEFRAMES period, // период

int cmo_period, // период Chande Momentum

int ema_period, // период фактора сглаживания

int ma_shift, // смещение индикатора по горизонтали

ENUM_APPLIED_PRICE applied_price // тип цены или handle

);

Параметры

symbol

[in] Символьное имя инструмента, на данных которого будет вычисляться индикатор. NULL

означает текущий символ.

period

[in] Значение периода может быть одним из значений перечисления ENUM_TIMEFRAMES, 0

означает текущий таймфрейм.

cmo_period

[in] Период(количество баров) для вычисления Chande Momentum Oscillator.

ema_period

[in] Период(количество баров) EMA для вычисления фактора сглаживания.

ma_shift

[in] Сдвиг индикатора относительно ценового графика.

applied_price

[in] Используемая цена. Может быть любой из ценовых констант ENUM_APPLIED_PRICE или

хендлом другого индикатора.

Возвращаемое значение

Возвращает хэндл указанного технического индикатора, в случае неудачи возвращает

INVALID_HANDLE. Для освобождения памяти компьютера от неиспользуемого больше

индикатора служит функция IndicatorRelease(), которой передается хэндл этого индикатора.

Технические индикаторы

904

iVolumes

Возвращает хэндл индикатора, отображающего объемы . Всего один буфер.

int iVolumes(

string symbol, // имя символа

ENUM_TIMEFRAMES period, // период

ENUM_APPLIED_VOLUME applied_volume // тип объема

)

Параметры

symbol

[in] Символьное имя инструмента, на данных которого будет вычисляться индикатор. NULL

означает текущий символ.

period

[in] Значение периода может быть одним из значений перечисления ENUM_TIMEFRAMES, 0

означает текущий таймфрейм.

applied_volume

[in] Используемый объем. Может быть любой из значений перечисления

ENUM_APPLIED_VOLUME.

Возвращаемое значение

Возвращает хэндл указанного технического индикатора, в случае неудачи возвращает

INVALID_HANDLE. Для освобождения памяти компьютера от неиспользуемого больше

индикатора служит функция IndicatorRelease(), которой передается хэндл этого индикатора.

Работа с событиями

905

Работа с событиями

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

существуют также специальные функции, для обработки предопределенныхсобытий.

Функция

Действие

EventSetTimer

Запускает генератор событий таймера с

указанной периодичностью для текущего

графика

EventKillTimer

Останавливает на текущем графике

генерацию событий по таймеру

EventChartCustom

Генерирует пользовательское событие для

указанного графика

Смотри также

Типы событий графика

Работа с событиями

906

EventSetTimer

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

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

bool EventSetTimer(

int seconds // количество секунд

);

Параметры

seconds

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

Возвращаемое значение

В случае успешного выполнения возвращает true, иначе false. Для получения кода ошибки

нужно вызвать функцию GetLastError().

Примечание

Обычно, эта функция должна вызываться из функции OnInit() или в конструкторе класса. Для

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

иметь функцию OnTimer().

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

от него. При завершении работы mql5-программы таймер уничтожается принудительно, если он

был создан, но не был отключен функцией EventKillTimer().

Для каждой программы может быть запущено не более одного таймера.

Работа с событиями

907

EventKillTimer

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

для данного эксперта или индикатора.

void EventKillTimer();

Возвращаемое значение

Нет возвращаемого значения.

Примечание

Обычно эта функция должна вызываться из функции OnDeinit() в том случае, если в функции

OnInit() была вызвана функция EventSetTimer(). Либо должна вызываться из деструктора

класса, если в конструкторе этого класса вызывается функция EventSetTimer().

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

от него. При завершении работы mql5-программы таймер уничтожается принудительно, если он

был создан, но не был отключен функцией EventKillTimer().

Работа с событиями

908

EventChartCustom

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

bool EventChartCustom(

long chart_id, // идентификатор графика-получателя события

ushort custom_event_id, // идентификатор события

long lparam, // параметр типа long

double dparam, // параметр типа double

string sparam // строковый параметр события

);

Параметры

chart_id

[in] Идентификатор графика. 0 означает текущий график.

custom_event_id

[in] Идентификатор пользовательского события. Этот идентификатор автоматически

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

lparam

[in] Параметр события типа long, передаваемый функции OnChartEvent.

dparam

[in] Параметр события типа double, передаваемый функции OnChartEvent.

sparam

[in] Параметр события типа string, передаваемый функции OnChartEvent. Если строка имеет

длину больше, чем 63 символа, то строка усекается.

Возвращаемое значение

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

В случае ошибки возвращает false, для получения кода ошибки используйте GetLastError().

Примечание

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

при помощи функции OnChartEvent(int event_id, long& lparam, double& dparam, string& sparam).

Для каждого типа события входные параметры функции OnChartEvent() имеют определенные

значения, которые необходимы для обработки этого события. В таблице перечислены события и

значения, которые передаются через параметры.

Событие

Значение

параметра id

Значение

параметра

lparam

Значение

параметра

dparam

Значение

параметра

sparam

Событие

нажатия

клавиатуры

CHARTEVENT_KE

YDOWN

код нажатой

клавиши

—

Работа с событиями

909

Событие

создания

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

объекта

CHARTEVENT_OB

JECT_CREATE

—

Имя созданного

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

объекта

Событие

изменения

свойств объекта

через диалог

свойств

CHARTEVENT_OB

JECT_CHANGE

—

Имя

измененного

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

объекта

Событие

удаления

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

объекта

CHARTEVENT_OB

JECT_DELETE

—

Имя удаленного

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

объекта

Событие щелчка

мыши графике

CHARTEVENT_CL

ICK

X координата

Y координата

—

Событие щелчка

мыши на

графическом

объекте

CHARTEVENT_OB

JECT_CLICK

X координата

Y координата

Имя

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

объекта, на

котором

произошло

событие

Событие

перемещения

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

объекта при

помощи мыши

CHARTEVENT_OB

JECT_DRAG

—

Имя

перемещенного

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

объекта

Событие

окончания

редактирования

текста в поле

ввода

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

объекта "Поле

ввода"

CHARTEVENT_OB

JECT_ENDEDIT

—

Имя

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

объекта "Поле

ввода", в

котором

завершилось

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

текста

Событие

изменения

графика

CHARTEVENT_C

HART_CHANGE

—

Пользовательск

ое событие с

номером N

CHARTEVENT_CU

STOM+N

Значение,

заданное

функцией

EventChartCusto

m()

Значение,

заданное

функцией

EventChartCusto

m()

Значение,

заданное

функцией

EventChartCusto

m()

Пример:

Работа с событиями

910

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

//| ButtonClickExpert.mq5 |

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

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

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

#property version "1.00"

string buttonID="Button";

string labelID="Info";

int broadcastEventID=5000;

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

//| Expert initialization function |

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

int OnInit()

{

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

ObjectCreate(0,buttonID,OBJ_BUTTON,0,100,100);

ObjectSetInteger(0,buttonID,OBJPROP_COLOR,clrWhite);

ObjectSetInteger(0,buttonID,OBJPROP_BGCOLOR,clrGray);

ObjectSetInteger(0,buttonID,OBJPROP_XDISTANCE,100);

ObjectSetInteger(0,buttonID,OBJPROP_YDISTANCE,100);

ObjectSetInteger(0,buttonID,OBJPROP_XSIZE,200);

ObjectSetInteger(0,buttonID,OBJPROP_YSIZE,50);

ObjectSetString(0,buttonID,OBJPROP_FONT,"Arial");

ObjectSetString(0,buttonID,OBJPROP_TEXT,"Кнопка");

ObjectSetInteger(0,buttonID,OBJPROP_FONTSIZE,10);

ObjectSetInteger(0,buttonID,OBJPROP_SELECTABLE,0);

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

ObjectCreate(0,labelID,OBJ_LABEL,0,100,100);

ObjectSetInteger(0,labelID,OBJPROP_COLOR,clrRed);

ObjectSetInteger(0,labelID,OBJPROP_XDISTANCE,100);

ObjectSetInteger(0,labelID,OBJPROP_YDISTANCE,50);

ObjectSetString(0,labelID,OBJPROP_FONT,"Trebuchet MS");

ObjectSetString(0,labelID,OBJPROP_TEXT,"Нет информации");

ObjectSetInteger(0,labelID,OBJPROP_FONTSIZE,20);

ObjectSetInteger(0,labelID,OBJPROP_SELECTABLE,0);

//---

return(0);

}

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

//| Expert deinitialization function |

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

void OnDeinit(const int reason)

{

//---

ObjectDelete(0,buttonID);

ObjectDelete(0,labelID);

}

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

//| Expert tick function |

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

void OnTick()

{

//---

}

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