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

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

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

Свойства

• dayOfWeekFormat : int
• frameVisible : bool
• locale : var
• maximumDate : дата
• minimumDate : дата
• navigationBarVisible : bool
• selectedDate : дата
• visibleMonth : int
• visibleYear : int
• weekNumbersVisible : bool

Сигналы

• clicked(date)
• doubleClicked(date)
• hovered(date)
• pressAndHold(date)
• pressed(date)
• released(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 : дата

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

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

minimumDate : дата

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

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

navigationBarVisible : bool

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

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

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

selectedDate : дата

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

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

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

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

new Date()

visibleMonth : int

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

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

См. также visibleYear.

visibleYear : int

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

См. также visibleMonth.

weekNumbersVisible : bool

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

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

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

clicked(date = дата)

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

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

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

doubleClicked(date = дата)

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

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

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

hovered(date = дата)

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

date — дата, над которой был наведен курсор.

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

pressAndHold(date = дата)

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

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

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

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

pressed(date = дата)

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

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

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

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

released(date = дата)

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

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

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

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

void showNextMonth()

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

void showNextYear()

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

void showPreviousMonth()

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

void showPreviousYear()

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