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

Новый элемент управления CCalendarInputBox библиотеки IncGUI предназначен для ввода даты и/или времени.

• Пользовательские графические элементы управления. Часть 1. Создание простого элемента управления
• Пользовательские графические элементы управления. Часть 2. Библиотека элементов управления
• Пользовательские графические элементы управления. Часть 3. Формы
  

Элемент управления CCalendarInputBox может применяться в различных режимах: ввод даты и времени, ввод даты, ввод времени.

Время может вводиться с точностью до минут или с точностью до секунд (на выбор). Дополнительно дата и время могут указываться перемещением вертикальной линии. В обычном состоянии элемент представляет собой текстовое поле с кнопкой. При нажатии на кнопку открывается вкладка.

На рисунке показана вкладка с пронумерованными элементами управления.

Открытая вкладка элемента управления CCalendarInput

1. Кнопки изменения года;
2. Список выбора месяца;
3. Кнопка перехода к предыдущему месяцу;
4. Кнопка перехода к следующему месяцу;
5. Информационная строка с названиями дней недели;
6. Дни предыдущего месяца (имеют более темный цвет фона по сравнению с днями текущего месяца);
7. День текущего месяца. Под текущим месяцем подразумевается выбранный месяц (2) выбранного года (1);
8. Выбранный день;
9. Действительный текущий день;
10. Дни следующего месяца;
11. Кнопка установки действительной текущей даты;
12. Кнопка установки действительного текущего времени;
13. Действительная текущая дата;
14. Выбор времени;
15. Действительное текущее время;
16. Включение вертикальной линии для указания даты-времени;
17. Закрытие вкладки без применения новой даты-времени;
18. Закрытие вкладки с применением новой даты-времени.

Применение элемента управления начинается с вызова метода Init(), при его вызове указываются следующие параметры:

• string aName="CCalendar" - имя элемента управления;
• bool aDate=true - используется ли ввод даты;
• bool aTime=true - используется ли ввод времени;
• bool aSeconds=true - время с точностью до секунд;
• bool aLine=true - используется ли ввод вертикальной линией (дополнительно к вводу даты и/или времени);
• int aTimeMode=0 - тип текущего времени: 0 - время терминала, 2 - локальное время (время и дата отображаемые на позициях 13 и 15 приведенного рисунка);
• string aCaption - текст надписи рядом с элементом управления.
  

Получение текущего значения выполняется методами ValueDateTime() (в формате datetime) и ValueString() (в формате string). Программная установка времени выполняется методом SetValueDateTime().

В различных режимах (ввод даты/времени) элемент управления имеет различную ширину, соответствующую длине отображаемого значения, но ширина может быть изменена методом SetWidth(). Элемент управления выполнен в виде двух классов CCalendar (самостоятельно не используется) и CCalendarInputBox. Оба класса добавлены в файл IncGUI_v4.mqh (находится в приложении).

В приложении находится файл IncGUIv4mqh.chm (документация к библиотеке IncGUI_v4.mqh), подготовленная в программе doxygen и эксперт eIncGUI_v4_Test_CCalendarInputBox.mq5 с примером использования элемента управления.