En esta página

MonthGrid QML Type

Una tabla con los días de un mes natural. Más...

Import Statement: import QtQuick.Controls
Inherits:

Control

Propiedades

Señales

Descripción detallada

MonthGrid presenta un mes natural en forma de cuadrícula. Los contenidos se calculan a partir de un month y un year determinados, utilizando el locale especificado.

Cuadrícula mensual en la que se muestran los días del calendario

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

MonthGrid puede utilizarse como un control independiente, pero lo más habitual es utilizarlo junto con DayOfWeekRow y WeekNumberColumn. Independientemente del caso de uso, la ubicación de la cuadrícula queda a criterio del usuario.

Cuadrícula mensual en formato de calendario

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
    }
}

El aspecto visual de MonthGrid se puede modificar implementando un ` custom delegate`.

Al visualizar cualquier mes determinado, MonthGrid muestra los días del mes anterior y del siguiente. Esto significa que siempre muestra seis filas, incluso cuando la primera o la última fila se encuentran íntegramente dentro de un mes adyacente.

Localización de los días

Para localizar los días, utiliza Locale.toString(). Por ejemplo, para mostrar los números de los días en una configuración regional árabe:

MonthGrid {
    id: monthGrid
    month: Calendar.December
    year: 2015
    locale: Qt.locale("ar")
    delegate: Text {
        horizontalAlignment: Text.AlignHCenter
        verticalAlignment: Text.AlignVCenter
        opacity: model.month === monthGrid.month ? 1 : 0
        text: monthGrid.locale.toString(model.date, "d")
        font: monthGrid.font

        required property var model
    }
}

Véase también « DayOfWeekRow» , « WeekNumberColumn », « CalendarModel » y «Qt Quick » en la sección «Controles - Calendario de eventos».

Documentación de propiedades

delegate : Component

Esta propiedad contiene el delegado de elemento que muestra cada día.

Además de la propiedad « index », hay disponible una lista de roles de datos del modelo en el contexto de cada delegado:

model.date: fechaLa fecha de la celda
model.day: intEl número del día
model.today: boolSi el delegado representa el día de hoy
model.weekNumber: intEl número de la semana
model.month: intEl número del mes
model.year: intEl número del año

El siguiente fragmento de código muestra la implementación por defecto del delegado de elemento. Se puede utilizar como punto de partida para implementar delegados personalizados.

MonthGrid no asume la propiedad del delegado.

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

    required property var model
}

month : int

Esta propiedad contiene el número del mes. El valor por defecto es el mes actual.

Los tipos relacionados con el calendario en los controles deQt Quick utilizan números de mes que comienzan por 0, al igual que los objetos Date de JavaScript. Sin embargo, esto difiere de QDate, donde los meses se numeran a partir del 1.

Para evitar confusiones, puede utilizar los siguientes valores de enumeración:

ConstanteDescripción
Calendar.JanuaryEnero (0)
Calendar.FebruaryFebrero (1)
Calendar.MarchMarzo (2)
Calendar.AprilAbril (3)
Calendar.MayMayo (4)
Calendar.JuneJunio (5)
Calendar.JulyJulio (6)
Calendar.AugustAgosto (7)
Calendar.SeptemberSeptiembre (8)
Calendar.OctoberOctubre (9)
Calendar.NovemberNoviembre (10)
Calendar.DecemberDiciembre (11)

Véase también Calendar.

title : string

Esta propiedad contiene el título del calendario.

Esta propiedad se proporciona por comodidad. MonthGrid no muestra el título por sí mismo. El valor por defecto está formado por el nombre del mes, con el formato establecido en locale, y el número del año.

year : int

Esta propiedad contiene el número del año.

El valor debe estar comprendido entre -271820 y 275759. El valor por defecto es el año actual.

Documentación de Signal

clicked(date date)

Esta señal se emite al hacer clic en date.

Nota: El controlador correspondiente es onClicked.

pressAndHold(date date)

Esta señal se emite cuando se mantiene pulsada la tecla « date ».

Nota: El controlador correspondiente es onPressAndHold.

pressed(date date)

Esta señal se emite al pulsar date.

Nota: El controlador correspondiente es onPressed.

released(date date)

Esta señal se emite cuando se suelta date.

Nota: El controlador correspondiente es onReleased.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.