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

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

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

Свойства

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

Сигналы

• clicked(дата)
• doubleClicked(дата)
• hovered(дата)
• pressAndHold(дата)
• pressed(дата)
• released(дата)

Методы

• 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(дата = дата)

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

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

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

doubleClicked(дата = дата)

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

дата — дата, по которой дважды нажата кнопка мыши.

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

hovered(дата = дата)

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

дата — дата, на которую наведен курсор.

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

pressAndHold(дата = дата)

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

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

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

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

pressed(дата = дата)

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

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

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

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

released(дата = дата)

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

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

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

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

void showNextMonth()

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

void showNextYear()

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

void showPreviousMonth()

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

void showPreviousYear()

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