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