ObjectCreateAndSet - библиотека для MetaTrader 5

В прилагаемом файле с расширением *.mqh — функции для создания объектов и/или изменения значений свойств объектов. Мне он особенно удобен в применении, когда нужно быстро создать какой-либо тестовый код, где требуется прописать попутно создание каких-либо объектов на графике и/или изменение каких-либо свойств объектов из уже имеющихся на графике.

Другой файл — это скрипт с тестовым примером применения функций из прилагаемого файла (создает текстовую метку, постепенно поворачивает ее текст на 90 градусов, попутно меняя текст и его цвет).

I. Функции для создания объектов:

Cформированы на основе находящихся в Справочнике по MQL5. Основные отличия от одноименных функций в справочнике:

• добавлены строки для установки всплывающих подсказок и строки для выбора установки видимости объектов на различных таймфреймах;
• убраны строки с функциями формирования объектов при не заданных координатах, ценах, точках привязок (за исключением в VLineCreate(...) и EventCreate(...));
• за счет имеющихся в прилагаемом файле функций по установке (изменению) свойств объектов, при создании объектов добавлены дополнительные условия проверки успешности установки значений свойств.

Список находящихся в файле функций для создания объектов:

II. Функции установки значений свойств:

Через ObjectSetDouble(...), ObjectSetInteger(...) и ObjectSetString(...) без указания модификатора:

Через ObjectSetDouble(...), ObjectSetInteger(...) и ObjectSetString(...) с указанием модификатора:

Дополнительные функции в файле:

III. Cпособы применения файла:

Его можно применять как включаемый файл или просто копировать функции из него в создаваемый вами код.

При втором варианте удобно, с моей точки зрения, применить его при создании какого-либо кода сначала как включаемый файл. И лишь после того, как в коде будут прописаны все обращения к функциям из него, затем удалить из создаваемого кода строку ссылки на файл(#include...).

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

Применение в виде включаемого файла:

1. Сохраните прилагаемый выше файл ObjectCreateAndSet.mqh в папке "Include". Для вставки файла в эту папку, ее можно открыть через Навигатор в MetaEditor, кликнув в Навигаторе на папке с названием "Include" правой кнопкой мыши и затем нажав в открывшемся меню на строку "Открыть папку".
   
   
2. При создании кода, где будут применяться функции из этого файла, скопируйте в самом верху файла строку с #include... и поставьте ее затем в верху создаваемого вами кода:
   

   #include <ObjectCreateAndSet.mqh>

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

Рис.1. Всплывающая подсказка после набора первых букв имени функции

Рис.2. Всплывающая подсказка с параметрами для выбранной функции

На всякий случай упомяну, что содержащиеся в каком-либо конкретном файле функции удобно смотреть и через Список функций на панели инструментов MetaEditor:

Рис.3. Кнопка для вызова списка функций, содержащихся в файле

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

Рис.4. После нажатия кнопки вызова списка функций открывается список функций в файле (удобно для быстрого перехода к коду какой-либо функции и/или просто для просмотра имеющихся)

Обновления:

• 2015.09.14: В функции ObDelete() добавлен вывод имени объекта в журнал вкладки терминала "Эксперты", если при удалении объекта возникла ошибка. Это облегчает поиск в коде причины ошибки в случае ее возникновения.