Русский

Справочник MQL4 Графические объекты ObjectSetString

Справка MQL4 одним файлом:

ObjectSetString

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

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

bool  ObjectSetString(
   long     chart_id,      // идентификатор графика
   string   object_name,   // имя
   int      prop_id,       // свойство
   string   prop_value     // значение
   );

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

bool  ObjectSetString(
   long     chart_id,       // идентификатор графика
   string   object_name,    // имя
   int      prop_id,        // свойство
   int      prop_modifier,  // модификатор
   string   prop_value      // значение
   );

Параметры

chart_id

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

object_name

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

prop_id

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

prop_modifier

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

prop_value

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

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

Возвращает true только в том случае, если команда на изменение свойств графического объекта успешно отправлена графику, иначе возвращает false. Чтобы получить дополнительную информацию об ошибке, необходимо вызвать функцию GetLastError().

Примечание

При использовании функции на собственном графике осуществляется прямой доступ к графику и результат выполнения возвращается сразу же. В то время как для установки свойств объекта на чужом графике всегда используется асинхронный вызов. Асинхронный вызов означает, что функция не дожидается выполнения команды, успешно поставленной в очередь чужого графика, а сразу же возвращает управление.

Для проверки результата выполнения на чужом графике можно использовать функцию, запрашивающую указанное свойство объекта. Но при этом следует иметь в виду, что такие функции ставятся в конец очереди команд чужого графика и дожидаются результата выполнения, то есть могут быть затратными по времени. Нужно иметь это обстоятельство в виду, если ведется работа с большим количеством объектов на графике.