Тип MonthGrid QML

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

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

Свойства

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

Сигналы

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

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

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

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 сам по себе не визуализирует заголовок. Значение по умолчанию состоит из названия месяца, отформатированного с использованием locale, и номера года.

year : int

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

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

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

clicked(date)

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

pressAndHold(date)

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

pressed(date)

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

released(date)

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