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

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

Графические объекты

851

ObjectSetString

Задает значение соответствующего свойства объекта. Свойство объекта должно быть типа string.

Существует 2 варианта функции.

Установка значения свойства, не имеющего модификатора

bool ObjectSetString(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

string prop_value  // значение

);

Установка значения свойства с указанием модификатора

bool ObjectSetString(

long chart_id, // идентификатор графика

string name, // имя

int prop_id, // свойство

int prop_modifier, // модификатор

string prop_value  // значение

);

Параметры

chart_id

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

name

[in] Имя объекта.

prop_id

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

ENUM_OBJECT_PROPERTY_STRING.

prop_modifier

[in] Модификатор указанного свойства. Означает номер уровня в инструментах Фибоначчи и в

графическом объекте Вилы Эндрюса. Нумерация уровней начинается с нуля.

prop_value

[in] Значение свойства.

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

Возвращает true только в том случае, если команда на изменение свойств графического

объекта успешно отправлена графику, иначе возвращает false. Чтобы получить дополнительную

информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

При переименовании графического объекта одновременно формируются два события, которые

можно обработать в эксперте или индикаторе функцией OnChartEvent():

Графические объекты

852

событие удаления объекта со старым именем;

событие создания графического объекта с новым именем.

Графические объекты

853

ObjectGetDouble

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

double. Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

double ObjectGetDouble(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier=0 // модификатор свойства, если требуется

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

параметром.

bool ObjectGetDouble(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier, // модификатор свойства

double&double_var // сюда примем значение свойства

);

Параметры

chart_id

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

name

[in] Имя объекта.

prop_id

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

ENUM_OBJECT_PROPERTY_DOUBLE.

prop_modifier

[in] Модификатор указанного свойства. Для первого варианта по умолчанию значение

модификатора равно 0. Большинство свойств не требуют модификатора. Означает номер

уровня в инструментах Фибоначчи и в графическом объекте Вилы Эндрюса. Нумерация

уровней начинается с нуля.

double_var

[out] Переменная типа double, принимающая значение запрашиваемого свойства.

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

Значение типа double для первого варианта вызова.

Для второго варианта вызова возвращает true, если данное свойство поддерживается и

значение было помещено в переменную double_var, иначе возвращает false. Чтобы получить

Графические объекты

854

дополнительную информацию об ошибке, необходимо вызвать функцию GetLastError().

Графические объекты

855

ObjectGetInteger

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

datetime,int,color,boolилиchar. Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

long ObjectGetInteger(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier=0 // модификатор свойства, если требуется

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

параметром.

bool ObjectGetInteger(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier, // модификатор свойства

long& long_var // сюда примем значение свойства

);

Параметры

chart_id

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

name

[in] Имя объекта.

prop_id

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

ENUM_OBJECT_PROPERTY_INTEGER.

prop_modifier

[in] Модификатор указанного свойства. Для первого варианта по умолчанию значение

модификатора равно 0. Большинство свойств не требуют модификатора. Означает номер

уровня в инструментах Фибоначчи и в графическом объекте Вилы Эндрюса. Нумерация

уровней начинается с нуля.

long_var

[out] Переменная типа long, принимающая значение запрашиваемого свойства.

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

Значение типа long для первого варианта вызова.

Для второго варианта вызова возвращает true, если данное свойство поддерживается и

значение было помещено в переменную long_var, иначе возвращает false. Чтобы получить

Графические объекты

856

дополнительную информацию об ошибке, необходимо вызвать функцию GetLastError().

Графические объекты

857

ObjectGetString

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

string. Существует 2 варианта функции.

1. Непосредственно возвращает значение свойства.

string ObjectGetString(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier=0 // модификатор свойства, если требуется

);

2. Возвращает true или false в зависимости от успешности выполнения функции. В случае успеха

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

параметром.

bool ObjectGetString(

long chart_id, // идентификатор графика

string name, // имя объекта

int prop_id, // идентификатор свойства

int prop_modifier, // модификатор свойства

string&string_var // сюда примем значение свойства

);

Параметры

chart_id

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

name

[in] Имя объекта.

prop_id

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

ENUM_OBJECT_PROPERTY_STRING.

prop_modifier

[in] Модификатор указанного свойства. Для первого варианта по умолчанию значение

модификатора равно 0. Большинство свойств не требуют модификатора. Означает номер

уровня в инструментах Фибоначчи и в графическом объекте Вилы Эндрюса. Нумерация

уровней начинается с нуля.

string_var

[out] Переменная типа string, принимающая значение запрашиваемого свойства.

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

Значение типа string для первого варианта вызова.

Для второго варианта вызова возвращает true, если данное свойство поддерживается и

значение было помещено в переменную string_var, иначе возвращает false. Чтобы получить

Графические объекты

858

дополнительную информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

При переименовании графического объекта одновременно формируются два события, которые

можно обработать в эксперте или индикаторе функцией OnChartEvent():

событие удаления объекта со старым именем;

событие создания графического объекта с новым именем.

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

859

Функции для работы с техническими индикаторами

Все функции типа iMA, iAC, iMACD, iIchimoku и т.п., создают в глобальном кеше клиентского

терминала копию соответствующего технического индикатора. Если копия индикатора с этими

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

данную копию.

Эти функции возвращают хэндл соответствующей копии индикатора. Используя этот хэндл в

дальнейшем можно получать данные, рассчитанные соответствующим индикатором. Данные

соответствующего буфера (технические индикаторы содержат рассчитанные данные в своих

внутренних буферах, которых, в зависимости от индикатора, может быть от 1 до 5) можно

копировать в mql5-программу при помощи функции CopyBuffer().

Нельзя обратиться к данным индикатора сразу после его создания, так как на расчет значений

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

OnInit(). Функция iCustom() создает соответствующий пользовательский индикатор и при

успешном создании возвращает его хэндл. Пользовательские индикаторы могут содержать до 512

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

CopyBuffer(), используя полученный хэндл.

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

IndicatorCreate(). Эта функция получает в качестве входных параметров:

имя символа;

таймфрейм;

тип создаваемого индикатора;

количество входных параметров индикатора;

массив типа MqlParam, содержащий все необходимые входные параметры.

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

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

Примечание. Многократное обращение к функции индикатора с одними и теми же параметрами в

пределах одной mql5-программы не приводит к многократному увеличению счетчика ссылок,

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

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

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

программы.

Все индикаторные функции имеют как минимум 2 параметра - символ и период. Значение символа

NULL означает текущий инструмент, значение периода 0 означает текущий таймфрейм.

Функция

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

iAC

Accelerator Oscillator

iAD

Accumulation/Distribution

iADX

Average Directional Index

iADXWilder

Average Directional Index by Welles Wilder

iAlligator

Alligator

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

860

iAMA

Adaptive Moving Average

iAO

Awesome Oscillator

iATR

Average True Range

iBearsPower

Bears Power

iBands

Bollinger Bands

iBullsPower

Bulls Power

iCCI

Commodity Channel Index

iChaikin

Chaikin Oscillator

iCustom

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

iDEMA

Double Exponential Moving Average

iDeMarker

DeMarker

iEnvelopes

Envelopes

iForce

Force Index

iFractals

Fractals

iFRAMA

Fractal Adaptive Moving Average

iGator

Gator Oscillator

iIchimoku

Ichimoku Kinko Hyo

iBWMFI

Market Facilitation Index by Bill Williams

iMomentum

Momentum

iMFI

Money Flow Index

iMA

Moving Average

iOsMA

Moving Average of Oscillator (MACD histogram)

iMACD

Moving Averages Convergence-Divergence

iOBV

On Balance Volume

iSAR

Parabolic Stop And Reverse System

iRSI

Relative Strength Index

iRVI

Relative Vigor Index

iStdDev

Standard Deviation

iStochastic

Stochastic Oscillator

iTEMA

Triple Exponential Moving Average

iTriX

Triple Exponential Moving Averages Oscillator

iWPR

Williams' Percent Range