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

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

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

Свойства

• dayOfWeekFormat : int
• frameVisible : bool
• maximumDate : дата
• minimumDate : дата
• navigationBarVisible : bool
• selectedDate : дата
• style : Компонент
• 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 String Format Types), и Locale.LongFormat может не поместиться в ячейки заголовка.

frameVisible : bool

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

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

maximumDate : дата

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

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

minimumDate : дата

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

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

navigationBarVisible : bool

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

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

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

selectedDate : дата

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

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

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

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

new Date()

style : Компонент

Компонент стиля для этого элемента управления.

См. такжеТипы QML Qt Quick Controls Styles.

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.

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

pressed(дата date)

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

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

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

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

released(дата date)

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

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

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

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

void showNextMonth()

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

void showNextYear()

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

void showPreviousMonth()

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

void showPreviousYear()

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