Виджет «Календарь» обеспечивает возможность выбора желаемой даты.
 

Рисунок: Календарь

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

При инициализации календаря автоматически устанавливается текущая дата (год, месяц, день). Ниже приведено описание различных способов изменения даты.

Год

Для изменения года необходимо щелкнуть левой кнопкой мыши по году в календаре. Изменение может быть выполнено, например, при помощи стрелок счетчика. Шаг равен одному году.

Месяц

Доступны три способа изменения месяца:

1. Щелчком левой кнопки мыши по месяцу в календаре. При этом будет раскрыт выпадающий список из двенадцати месяцев, из которого может быть выбран требуемый месяц.
2. При помощи зеленых стрелок в левом и правом верхних углах календаря, при этом шаг изменения равен одному месяцу.
3. При помощи клавиш «Страница вверх» (Page Up) и «Страница вниз» (Page Down).

День

Доступны два способа изменения дня:

1. Щелчком левой кнопки мыши по требуемому дню.
2. При помощи клавиш управления курсором (перемещение по календарю вверх, вниз, влево или вправо).

При двойном щелчке по календарю, находящемуся на панели в режиме редактирования, происходит открытие сценария для события Clicked в Редакторе сценариев.

В том случае, если для дополнительного (расширенного) свойства «dateEditenabled» (bool) (изменение даты разрешено) задано значение «TRUE», и виджет календаря находится в фокусе, то при нажатии любой цифровой или буквенной клавиши, на 1,5 секунды отображается редактор даты (для настройки времени отображения редактора даты после последнего пользовательского ввода используется свойство: «dateEditAcceptDelay» (задержка для принятия изменений в редакторе даты)). При помощи клавиш клавиатуры в редакторе даты может быть введена новая дата (в формате согласно текущим региональным настройкам (locale)). Значение свойства «dateEditAcceptDelay» (целое число) задается в миллисекундах. По истечении указанного времени, дата, указанная в редакторе даты, принимается, и окно закрывается.

Рисунок: Расширенные свойства календаря

Для задания первого дня недели календаря служит свойство «firstDayOfWeek» (первый день недели).

Для управления разрешением на изменение даты в календаре пользователем служит свойство «Режим выбора» (selectionMode) («SingleSelection» = изменение разрешено, «NoSelection» = изменение запрещено).
 

Информация о функциях языка Control, применимых к Календарю, приведена в разделе «Язык сценариев Control/Функции для работы с графическими объектами/Календарь (функции Control)«.