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

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

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

241

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

Существует два способа программно создавать хэндл индикатора для последующего доступа к его

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

технических индикаторов. Второй способ позволяет с помощью функции IndicatorCreate()

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

ENUM_INDICATOR. Оба варианта создания хэндла индикатора равноправны, можно использовать

тот, который наиболее удобен в каждом конкретном случае при написании программы на MQL5.

При создании индикатора типа IND_CUSTOM, поле type первого элемента массива входных

параметров MqlParam обязательно должен иметь значение TYPE_STRING из перечисления

ENUM_DATATYPE, а поле string_value первого элемента должно содержать имя пользовательского

индикатора.

ENUM_INDICATOR

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

Индикатор

IND_AC

Accelerator Oscillator

IND_AD

Accumulation/Distribution

IND_ADX

Average Directional Index

IND_ADXW

ADX by Welles Wilder

IND_ALLIGATOR

Alligator

IND_AMA

Adaptive Moving Average

IND_AO

Awesome Oscillator

IND_ATR

Average True Range

IND_BANDS

Bollinger Bands

IND_BEARS

Bears Power

IND_BULLS

Bulls Power

IND_BWMFI

Market Facilitation Index

IND_CCI

Commodity Channel Index

IND_CHAIKIN

Chaikin Oscillator

IND_CUSTOM

Custom indicator

IND_DEMA

Double Exponential Moving Average

IND_DEMARKER

DeMarker

IND_ENVELOPES

Envelopes

IND_FORCE

Force Index

IND_FRACTALS

Fractals

IND_FRAMA

Fractal Adaptive Moving Average

IND_GATOR

Gator Oscillator

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

242

IND_ICHIMOKU

Ichimoku Kinko Hyo

IND_MA

Moving Average

IND_MACD

MACD

IND_MFI

Money Flow Index

IND_MOMENTUM

Momentum

IND_OBV

On Balance Volume

IND_OSMA

OsMA

IND_RSI

Relative Strength Index

IND_RVI

Relative Vigor Index

IND_SAR

Parabolic SAR

IND_STDDEV

Standard Deviation

IND_STOCHASTIC

Stochastic Oscillator

IND_TEMA

Triple Exponential Moving Average

IND_TRIX

Triple Exponential Moving Averages Oscillator

IND_VIDYA

Variable Index Dynamic Average

IND_VOLUMES

Volumes

IND_WPR

Williams' Percent Range

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

243

Идентификаторы типов данных

При создании хэндла индикатора функцией IndicatorCreate() необходимо указывать последним

параметром массив типа MqlParam. Соответственно, структура MqlParam, описывающая

параметры индикатора, содержит специальное поле type. Это поле содержит информацию о типе

данных (вещественный, целочисленный или строковый тип), которые передаются конкретным

элементом этого массива. Значение этого поля структуры MqlParam может быть одним из

значений перечисления ENUM_DATATYPE.

ENUM_DATATYPE

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

Тип данных

TYPE_BOOL

bool

TYPE_CHAR

char

TYPE_UCHAR

uchar

TYPE_SHORT

short

TYPE_USHORT

ushort

TYPE_COLOR

color

TYPE_INT

int

TYPE_UINT

uint

TYPE_DATETIME

datetime

TYPE_LONG

long

TYPE_ULONG

ulong

TYPE_FLOAT

float

TYPE_DOUBLE

double

TYPE_STRING

string

Каждый элемент этого массива описывает соответствующий входной параметр создаваемого

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

строго выдержан в соответствии с описанием.

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

244

Состояние окружения

Константы, описывающие текущую среду выполнения mql5-программы делятся на группы:

Состояниеклиентскоготерминала – информация о клиентском терминале;

Информация о запущенной MQL5-программе – свойства mql5-программы, которые помогают

дополнительно управлять ее поведением;

Информация об инструменте – получение торговой информации об инструменте;

Информацияосчете – информация о текущем торговом счете;

Статистика тестирования – результаты тестирования эксперта.

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

245

Состояние клиентского терминала

Идентификаторы для получения информации о клиентском терминале функциями

TerminalInfoInteger() и TerminalInfoString(). В качестве параметра эти функции принимают

значения из перечислений ENUM_TERMINAL_INFO_INTEGER и ENUM_TERMINAL_INFO_STRING

соответственно.

ENUM_TERMINAL_INFO_INTEGER

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

Описание

Тип свойства

TERMINAL_BUILD

Номер билда запущенного

терминала

int

TERMINAL_CONNECTED

Наличие подключения к

торговому серверу

bool

TERMINAL_DLLS_ALLOWED

Разрешение на

использование DLL

bool

TERMINAL_TRADE_ALLOWED

Разрешение на торговлю

bool

TERMINAL_EMAIL_ENABLED

Разрешение на отправку

писем с использованием

SMTP-сервера и логина,

указанных в настройках

терминала

bool

TERMINAL_FTP_ENABLED

Разрешение на отправку

отчетов по FTP на указанный

сервер для указанного в

настройках терминала

торгового счета

bool

TERMINAL_MAXBARS

Максимальное количество

баров на графике

int

TERMINAL_LANGUAGE

Номер кодовой страницы

языка, установленного в

клиентском терминале

int

Файловые операции можно проводить только в двух каталогах, пути к которым можно получить

при запросе свойств TERMINAL_DATA_PATH и TERMINAL_COMMONDATA_PATH.

ENUM_TERMINAL_INFO_STRING

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

Описание

Тип свойства

TERMINAL_COMPANY

Имя компании

string

TERMINAL_NAME

Имя терминала

string

TERMINAL_PATH

Папка, из которой запущен

терминал

string

TERMINAL_DATA_PATH

Папка, в которой хранятся

string

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

246

данные терминала

TERMINAL_COMMONDATA_PAT

Общая папка всех

клиентских терминалов,

установленных на

компьютере

string

Для лучшего понимания путей, хранящихся в свойствах параметров TERMINAL_PATH,

TERMINAL_DATA_PATH и TERMINAL_COMMONDATA_PATH, рекомендуется выполнить скрипт,

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

компьютере.

Пример: скрипт выводит информацию о путях терминала

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

//| Check_TerminalPaths.mq5 |

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

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

#property copyright "2009, MetaQuotes Software Corp."

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

#property version "1.00"

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

//| Script program start function |

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

void OnStart()

{

//---

Print("TERMINAL_PATH = ",TerminalInfoString(TERMINAL_PATH));

Print("TERMINAL_DATA_PATH = ",TerminalInfoString(TERMINAL_DATA_PATH));

Print("TERMINAL_COMMONDATA_PATH = ",TerminalInfoString(TERMINAL_COMMONDATA_PATH));

}

В результате выполнения скрипта в Журнал Экспертов будут выведены сообщения, подобные

приведенным на рисунке ниже.

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

247

Информация о запущенной MQL5-программе

Константы, для получения информации о выполняющейся mql5-программе, перечислены в

ENUM_MQL5_INFO_INTEGER и ENUM_MQL5_INFO_STRING.

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

ENUM_MQL5_INFO_INTEGER

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

Описание

Тип свойства

MQL5_PROGRAM_TYPE

Тип mql5-программы

ENUM_PROGRAM_TYPE

MQL5_DLLS_ALLOWED

Разрешение на

использование DLL для

данной запущенной

программы

bool

MQL5_TRADE_ALLOWED

Разрешение на торговлю для

данной запущенной

программы

bool

MQL5_DEBUGGING

Признак работы запущенной

программы в режиме

отладки

bool

MQL5_TESTING

Признак работы запущенной

программы в тестере

bool

MQL5_OPTIMIZATION

Признак работы запущенной

программы в процессе

оптимизации

bool

MQL5_VISUAL_MODE

Признак работы запущенной

программы в визуальном

режиме тестирования

bool

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

ENUM_MQL5_INFO_STRING

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

Описание

Тип свойства

MQL5_PROGRAM_NAME

Имя запущенной mql5-

программы

string

MQL5_PROGRAM_PATH

Путь для данной

запущенной программы

string

Для получения информации о типе выполняемой программы предназначены значения

перечисления ENUM_PROGRAM_TYPE.

ENUM_PROGRAM_TYPE

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

248

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

Описание

PROGRAM_SCRIPT

Скрипт

PROGRAM_EXPERT

Эксперт

PROGRAM_INDICATOR

Индикатор

Пример:

ENUM_PROGRAM_TYPE mql_program=(ENUM_PROGRAM_TYPE)MQL5InfoInteger(MQL5_PROGRAM_TYPE);

switch(mql_program)

{

case PROGRAM_SCRIPT:

{

Print(__FILE__+" is script");

break;

}

case PROGRAM_EXPERT:

{

Print(__FILE__+" is Expert Advisor");

break;

}

case PROGRAM_INDICATOR:

{

Print(__FILE__+" is custom indicator");

break;

}

default:Print("MQL5 type value is ",mql_program);

}

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

249

Информация об инструменте

Для получения текущей рыночной информации служат функции SymbolInfoInteger(),

SymbolInfoDouble() и SymbolInfoString(). В качестве второго параметра этих функций допустимо

передавать один из идентификаторов из перечислений ENUM_SYMBOL_INFO_INTEGER,

ENUM_SYMBOL_INFO_DOUBLE и ENUM_SYMBOL_INFO_STRING соответственно.

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

ENUM_SYMBOL_INFO_INTEGER

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

Описание

Тип свойства

SYMBOL_SELECT

Признак того, что символ

выбран в Market Watch

bool

SYMBOL_VOLUME

Volume - объем в последней

сделке

long

SYMBOL_VOLUMEHIGH

Максимальный Volume за

день

long

SYMBOL_VOLUMELOW

Минимальный Volume за день

long

SYMBOL_VOLUMEBID

Объем в текущем Bid

long

SYMBOL_VOLUMEASK

Объем в текущем Ask

long

SYMBOL_TIME

Время последней котировки

datetime

SYMBOL_DIGITS

Количество знаков после

запятой

int

SYMBOL_SPREAD

Размер спреда в пунктах

int

SYMBOL_SPREAD_FLOAT

Признак плавающего спреда

bool

SYMBOL_TICKS_BOOKDEPTH

Максимальное количество

показываемых заявок в

стакане. Для инструментов,

не имеющих очереди заявок,

значение равно 0

int

SYMBOL_TRADE_CALC_MODE

Способ вычисления

стоимости контракта

ENUM_SYMBOL_CALC_MODE

SYMBOL_TRADE_MODE

Тип исполнения ордеров

ENUM_SYMBOL_TRADE_MODE

SYMBOL_START_TIME

Дата начала торгов по

инструменту (обычно

используется для фьючерсов)

datetime

SYMBOL_EXPIRATION_TIME

Дата окончания торгов по

инструменту (обычно

используется для фьючерсов)

datetime

SYMBOL_TRADE_STOPS_LEVEL

Минимальный отступ в

пунктах от текущей цены

int

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

250

закрытия для установки Stop

ордеров

SYMBOL_TRADE_FREEZE_LEVEL

Дистанция заморозки

торговых операций (в

пунктах)

int

SYMBOL_TRADE_EXEMODE

Режим заключения сделок

ENUM_SYMBOL_TRADE_EXECUT

ION

SYMBOL_SWAP_MODE

Модель расчета свопа

ENUM_SYMBOL_SWAP_MODE

SYMBOL_SWAP_ROLLOVER3DA

День недели для начисления

тройного свопа

ENUM_DAY_OF_WEEK

SYMBOL_EXPIRATION_MODE

Флаги разрешенных режимов

истечения ордера

int

SYMBOL_FILLING_MODE

Флаги разрешенных режимов

заливки ордера

int

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

ENUM_SYMBOL_INFO_DOUBLE

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

Описание

Тип свойства

SYMBOL_BID

Bid - лучшее предложение на

продажу

double

SYMBOL_BIDHIGH

Максимальный Bid за день

double

SYMBOL_BIDLOW

Минимальный Bid за день

double

SYMBOL_ASK

Ask - лучшее предложение на

покупку

double

SYMBOL_ASKHIGH

Максимальный Ask за день

double

SYMBOL_ASKLOW

Минимальный Ask за день

double

SYMBOL_LAST

Цена, по которой совершена

последняя сделка

double

SYMBOL_LASTHIGH

Максимальный Last за день

double

SYMBOL_LASTLOW

Минимальный Last за день

double

SYMBOL_POINT

Значение одного пункта

double

SYMBOL_TRADE_TICK_VALUE

Значение

SYMBOL_TRADE_TICK_VALUE_

PROFIT

double

SYMBOL_TRADE_TICK_VALUE_P

ROFIT

Рассчитанная стоимость тика

для прибыльной позиции

double

SYMBOL_TRADE_TICK_VALUE_L

OSS

Рассчитанная стоимость тика

для убыточной позиции

double