MonthGrid QML Type
Una tabla con los días de un mes natural. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
Señales
- clicked(date date)
- pressAndHold(date date)
- pressed(date date)
- released(date date)
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.

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.

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: fecha | La fecha de la celda |
| model.day: int | El número del día |
| model.today: bool | Si el delegado representa el día de hoy |
| model.weekNumber: int | El número de la semana |
| model.month: int | El número del mes |
| model.year: int | El 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:
| Constante | Descripción |
|---|---|
Calendar.January | Enero (0) |
Calendar.February | Febrero (1) |
Calendar.March | Marzo (2) |
Calendar.April | Abril (3) |
Calendar.May | Mayo (4) |
Calendar.June | Junio (5) |
Calendar.July | Julio (6) |
Calendar.August | Agosto (7) |
Calendar.September | Septiembre (8) |
Calendar.October | Octubre (9) |
Calendar.November | Noviembre (10) |
Calendar.December | Diciembre (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.