Тип 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 String Format Types) и 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 на предыдущий год.