Тип QML Calendar

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

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

Свойства

• dayOfWeekFormat : int
• frameVisible : bool
• locale : var
• maximumDate : date
• minimumDate : date
• navigationBarVisible : bool
• selectedDate : date
• 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 года н.э.

Calendar {
    minimumDate: new Date(2017, 0, 1)
    maximumDate: new Date(2018, 0, 1)
}

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

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

Calendar {
    weekNumbersVisible: true
}

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

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

dayOfWeekFormat : int

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

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

frameVisible : bool

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

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

locale : var

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

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

Следующий пример задает австралийское языковое окружение:

locale: Qt.locale("en_AU")

Значение по умолчанию эквивалентно Qt.locale().

Это свойство было добавлено в QtQuick.Controls 1.6.

maximumDate : date

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

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

minimumDate : date

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

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

navigationBarVisible : bool

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

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

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

selectedDate : date

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

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

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

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

new Date()

visibleMonth : int

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

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

См. также visibleYear.

visibleYear : int

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

См. также visibleMonth.

weekNumbersVisible : bool

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

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

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

clicked(date date)

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

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

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

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

doubleClicked(date date)

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

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

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

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

hovered(date date)

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

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

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

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

pressAndHold(date date)

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

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

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

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

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

pressed(date date)

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

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

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

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

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

released(date date)

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

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

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

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

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

void showNextMonth()

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

void showNextYear()

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

void showPreviousMonth()

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

void showPreviousYear()

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