Тип QML Календарь

Предоставляет способ выбора дат из календаря Подробнее...

• Список всех членов, включая унаследованные

Свойства

• dayOfWeekFormat : int
• frameVisible : bool
• maximumDate : date
• minimumDate : date
• navigationBarVisible : bool
• selectedDate : date
• style : Component
• visibleMonth : int
• visibleYear : int
• weekNumbersVisible : bool

Сигналы

• clicked(date date)
• doubleClicked(date date)
• hovered(date date)
• pressAndHold(date date)
• pressed(date date)
• released(date date)

Методы

• void showNextMonth()
• void showNextYear()
• void showPreviousMonth()
• void showPreviousYear()

Подробное описание

Календарь позволяет выбирать даты из сетки дней, аналогично QCalendarWidget.

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

Выбранную дату можно установить через selectedDate. Минимальную и максимальную дату можно установить через minimumDate и maximumDate. Наиболее ранней минимальной датой, которую можно установить, является 1 января 1 года нашей эры. Наиболее поздней максимальной датой, которую можно установить, является 25 октября 275759 года нашей эры.

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

Номера недель можно отображать, установив свойство weekNumbersVisible в true.

Calendar {
    weekNumbersVisible: true
}

Вы можете создать пользовательский вид для Календаря, назначив CalendarStyle.

Документация свойств

dayOfWeekFormat : int

Формат отображения дней недели (в заголовке).

Locale.ShortFormat является форматом по умолчанию и рекомендуется, так как Locale.NarrowFormat может быть не полностью поддерживаемым каждым языком (см. Типы форматов строк локализации), а Locale.LongFormat может не уместиться в ячейках заголовка.

frameVisible : bool

Это свойство определяет видимость рамки, окружающей календарь.

Значение по умолчанию — true.

maximumDate : date

Самая поздняя дата, которую этот календарь примет.

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

minimumDate : date

Самая ранняя дата, которую этот календарь примет.

По умолчанию это свойство установлено в самую раннюю минимальную дату (1 января 1 года нашей эры).

navigationBarVisible : bool

Это свойство определяет видимость панели навигации.

Значение по умолчанию — true.

Это свойство QML было введено в QtQuick.Controls 1.3.

selectedDate : date

Дата, выбранная пользователем.

Это свойство подвержено следующей валидации:

• Если selectedDate находится вне диапазона minimumDate и maximumDate, она будет ограничена этим диапазоном.
• selectedDate не будет изменена, если присвоено значение undefined или какое-либо другое недопустимое значение.
• Если установлены часы, минуты, секунды или миллисекунды, они будут удалены.

Значение по умолчанию — текущая дата, что эквивалентно:

new Date()

style : Component

Компонент стиля для этого элемента управления.

См. также Типы QML стилей Qt Quick Controls.

visibleMonth : int

Это свойство определяет, какой месяц в visibleYear отображается в календаре.

Номер месяца от 0 до 11 для соответствия объекту JavaScript Date.

См. также visibleYear.

visibleYear : int

Это свойство определяет, какой год отображается в календаре.

См. также visibleMonth.

weekNumbersVisible : bool

Это свойство определяет видимость номеров недель.

Значение по умолчанию — false.

Документация сигналов

clicked(date date)

Выдаётся, когда по действительной дате в календаре щелкают мышью.

date — это дата, по которой щелкнули мышью.

Соответствующий обработчик — onClicked.

doubleClicked(date date)

Выдаётся, когда по действительной дате в календаре дважды щелкают мышью.

date — это дата, по которой дважды щелкнули мышью.

Соответствующий обработчик — onDoubleClicked.

hovered(date date)

Выдаётся, когда курсор мыши находится над действительной датой в календаре.

date — это дата, над которой находился курсор.

Соответствующий обработчик — onHovered.

pressAndHold(date date)

Выдаётся, когда нажата и удерживается кнопка мыши на действительной дате в календаре.

date — это дата, на которой была нажата кнопка мыши.

Соответствующий обработчик — onPressAndHold.

Этот сигнал QML был введён в QtQuick.Controls 1.3.

pressed(date date)

Выдаётся, когда кнопка мыши нажата на действительной дате в календаре.

Также выдаётся при перетаскивании мыши на другую дату, пока она нажата.

date — это дата, на которой была нажата кнопка мыши.

Соответствующий обработчик — onPressed.

released(date date)

Выдаётся, когда кнопка мыши отпущена над действительной датой в календаре.

date — это дата, над которой была отпущена кнопка мыши.

Соответствующий обработчик — onReleased.

Документация методов

void showNextMonth()

Устанавливает visibleMonth на следующий месяц.

void showNextYear()

Устанавливает visibleYear на следующий год.

void showPreviousMonth()

Устанавливает visibleMonth на предыдущий месяц.

void showPreviousYear()

Устанавливает visibleYear на предыдущий год.