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

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

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

871

iBearsPower

Возвращает хэндл индикатора Bears Power. Всего один буфер.

int iBearsPower(

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

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

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

);

Параметры

symbol

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

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

period

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

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

ma_period

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

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

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

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

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

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

872

iBands

Возвращает хэндл индикатора Bollinger Bands.

int iBands(

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

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

int bands_period, // период для расчета средней линии

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

double deviation, // кол-во стандартных отклонений

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

);

Параметры

symbol

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

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

period

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

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

bands_period

[in] Период усреднения основной линии индикатора.

bands_shift

[in] Сдвиг индикатора относительно ценового графика. Необходимо помнить, что смещение

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

буферах хранятся без смещения. При получении значений буфера функцией CopyBuffer()

значение смещения никакого эффекта иметь не будет.

deviation

[in] Отклонение от основной линии.

applied_price

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

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

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

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

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

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

Примечание

Номера буферов: 0 - BASE_LINE, 1 - UPPER_BAND, 2 - LOWER_BAND

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

873

iBullsPower

Возвращает хэндл индикатора Bulls Power. Всего один буфер.

int iBullsPower(

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

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

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

);

Параметры

symbol

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

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

period

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

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

ma_period

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

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

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

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

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

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

874

iCCI

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

int iCCI(

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(), которой передается хэндл этого индикатора.

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

875

iChaikin

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

int iChaikin(

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

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

int fast_ma_period, // быстрый период

int slow_ma_period, // медленный период

ENUM_MA_METHOD ma_method, // тип сглаживания

ENUM_APPLIED_VOLUME applied_price // используемый объем

);

Параметры

symbol

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

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

period

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

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

fast_ma_period

[in] Быстрый период усреднения для вычисления индикатора.

slow_ma_period

[in] Медленный период усреднения для вычисления индикатора.

ma_method

[in] Тип усреднения.Может быть любой из констант усреднения ENUM_MA_METHOD.

applied_volume

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

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

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

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

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

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

876

iCustom

Возвращает хэндл указанного пользовательского индикатора.

int iCustom(

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

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

string name // папка/имя_пользовательского индикатора

... // список входных параметров индикатора

);

Параметры

symbol

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

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

period

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

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

name

[in] Имя пользовательского индикатора, содержащее путь относительно корневой директории

индикаторов (MQL5/Indicators/). Если индикатор находится в поддиректории, например, в

MQL5/Indicators/Examples, то имя должно выглядеть соответственно, а именно – "Examples\\

имя_индикатора" (обязательно указание двойного обратного слеша вместо одиночного в

качестве разделителя).

...

[in] input-параметры пользовательского индикатора, разделенные запятыми. Тип и порядок

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

использованы значенияпоумолчанию.

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

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

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

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

Примечание

Пользовательский индикатор должен быть скомпилирован (файл с расширением EX5) и

находиться в директории MQL5/Indicators клиентского терминала или вложенной

поддиректории.

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

iCustom(), если соответствующий параметр задан константной строкой. Для остальных случаев

(использование функции IndicatorCreate() или использование неконстантной строки в

параметре, задающем имя индикатора) необходимо указать свойство #property tester_indicator:

#property tester_indicator "indicator_name.ex5"

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

877

Если в индикаторе используется первая форма вызова, то при запуске пользовательского

индикатора на вкладке "Parameters" можно дополнительно указать на каких данных он будет

рассчитываться. Если параметр "Apply to" не выбран явно, то по умолчанию расчет производится

по значениям "Close".

При вызове пользовательского индикатора из mql5-программы параметр Applied_Price или хэндл

другого индикатора должен передаваться последним после всех предусмотренных

пользовательским индикатором входных переменных.

Смотри также

Свойства программ, Доступ к таймсериям и индикаторам, IndicatorCreate(), IndicatorRelease()

Пример:

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

878

#property indicator_separate_window

#property indicator_buffers 1

#property indicator_plots 1

//---- plot Label1

#property indicator_label1 "Label1"

#property indicator_type1 DRAW_LINE

#property indicator_color1 clrRed

#property indicator_style1 STYLE_SOLID

#property indicator_width1 1

//--- input parameters

input int MA_Period=21;

input int MA_Shift=0;

input ENUM_MA_METHOD MA_Method=MODE_SMA;

//--- indicator buffers

double Label1Buffer[];

//--- хэндл пользовательского индикатора Custom Moving Average.mq5

int MA_handle;

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

//| Custom indicator initialization function |

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

int OnInit()

{

//--- indicator buffers mapping

SetIndexBuffer(0,Label1Buffer,INDICATOR_DATA);

ResetLastError();

MA_handle=iCustom(NULL,0,"Custom Moving Average",

MA_Period,

MA_Shift,

MA_Method,

PRICE_CLOSE // считаем по ценам закрытия

);

Print("MA_handle = ",MA_handle," error = ",GetLastError());

//---

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

{

//--- скопируем значения индикатора Custom Moving Average в наш индикаторный буфер

int copy=CopyBuffer(MA_handle,0,0,rates_total,Label1Buffer);

Print("copy =",copy," rates_total =",rates_total);

//--- если попытка неудачная - сообщим об этом

if(copy<=0)

Print("Неудачная попытка получить значения индикатора Custom Moving Average");

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

return(rates_total);

}

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

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

879

iDEMA

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

int iDEMA(

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

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

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

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

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

);

Параметры

symbol

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

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

period

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

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

ma_period

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

ma_shift

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

applied_price

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

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

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

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

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

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

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

880

iDeMarker

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

int iDeMarker(

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

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

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

);

Параметры

symbol

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

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

period

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

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

ma_period

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

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

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

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

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