Тип MonthGrid QML

Сетка дней для календарного месяца. Подробнее...

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

Свойства

• delegate : Компонент
• month : int
• title : строка
• year : int

Сигналы

• clicked(date)
• pressAndHold(date)
• pressed(date)
• released(date)

Подробное описание

MonthGrid отображает календарный месяц в виде сетки. Содержимое рассчитывается для заданного месяца и года, используя указанный языковой стандарт.

MonthGrid {
    month: Calendar.December
    year: 2015
    locale: Qt.locale("en_US")
}

MonthGrid может использоваться как самостоятельный элемент управления, но чаще всего используется совместно с DayOfWeekRow и WeekNumberColumn. Независимо от варианта использования, позиционирование сетки остается на усмотрение пользователя.

GridLayout {
    columns: 2

    DayOfWeekRow {
        locale: grid.locale

        Layout.column: 1
        Layout.fillWidth: true
    }

    WeekNumberColumn {
        month: grid.month
        year: grid.year
        locale: grid.locale

        Layout.fillHeight: true
    }

    MonthGrid {
        id: grid
        month: Calendar.December
        year: 2015
        locale: Qt.locale("en_US")

        Layout.fillWidth: true
        Layout.fillHeight: true
    }
}

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

Примечание: Типы в модулях Qt.labs не гарантируют сохранение совместимости в будущих версиях.

См. также DayOfWeekRow, WeekNumberColumn и CalendarModel.

Документация по свойствам

delegate : Component

Это свойство содержит делегат элементов, который визуализирует каждый день.

В дополнение к свойству index, в контексте каждого делегата доступен список ролей данных модели:

Следующий фрагмент кода представляет собой стандартную реализацию делегата элемента. Он может быть использован в качестве отправной точки для реализации пользовательских делегатов.

delegate: Text {
    horizontalAlignment: Text.AlignHCenter
    verticalAlignment: Text.AlignVCenter
    opacity: model.month === control.month ? 1 : 0
    text: model.day
    font: control.font
}

month : int

Это свойство содержит номер месяца. Значение по умолчанию — текущий месяц.

Модуль Qt Labs Calendar использует нумерацию месяцев с нуля, что соответствует типу JavaScript Date, используемому в языке QML. Это означает, что Date::getMonth() может быть присвоено этому свойству как есть. При работе непосредственно с номерами месяцев настоятельно рекомендуется использовать следующие значения перечисления для избежания путаницы.

См. также Calendar.

title : строка

Это свойство содержит заголовок календаря.

Это свойство предоставлено для удобства. MonthGrid сам по себе не визуализирует заголовок. Значение по умолчанию состоит из имени месяца, отформатированного с использованием языкового стандарта, и номера года.

year : int

Это свойство содержит номер года.

Значение должно находиться в диапазоне от -271820 до 275759. Значение по умолчанию — текущий год.

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

clicked(date)

Этот сигнал генерируется при нажатии на date.

pressAndHold(date)

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

pressed(date)

Этот сигнал генерируется при нажатии на date.

released(date)

Этот сигнал генерируется при отпускании кнопки на date.