Estructura MCGRIDINFO (commctrl.h)

  • Artículo

Contiene información sobre parte de un control de calendario.

Sintaxis

typedef struct tagMCGRIDINFO {
  UINT       cbSize;
  DWORD      dwPart;
  DWORD      dwFlags;
  int        iCalendar;
  int        iRow;
  int        iCol;
  BOOL       bSelected;
  SYSTEMTIME stStart;
  SYSTEMTIME stEnd;
  RECT       rc;
  PWSTR      pszName;
  size_t     cchName;
} MCGRIDINFO, *PMCGRIDINFO;

Miembros

cbSize

Tipo: UINT

Tamaño de esta estructura, en bytes.

dwPart

Tipo: DWORD

Parte del control de calendario para el que se solicita información. Uno de los siguientes valores.

Valor Significado
MCGIP_CALENDARCONTROL
 El control de calendario completo, que puede incluir hasta 12 calendarios.
MCGIP_NEXT
 El botón siguiente.
MCGIP_PREV
 El botón anterior.
MCGIP_FOOTER
 Pie de página.
MCGIP_CALENDAR
 Un calendario específico. Se usa con iCalendar y pszName.
MCGIP_CALENDARHEADER
 Encabezado del calendario. Se usa con iCalendar y pszName.
MCGIP_CALENDARBODY
 Cuerpo del calendario. Se usa con iCalendar.
MCGIP_CALENDARROW
 Fila de calendario determinada. Se usa con iCalendar e iRow.
MCGIP_CALENDARCELL
 Celda de calendario determinada. Se usa con iCalendar, iRow, iCol, bSelected y pszName.

dwFlags

Tipo: DWORD

Indica qué información se va a rellenar. Combinación de uno o varios de los valores siguientes.

Valor Significado
MCGIF_DATE
 stStart y stEnd.
MCGIF_RECT
 rc.
MCGIF_NAME
 pszName.

iCalendar

Tipo: int

Si dwPart es MCGIP_CALENDAR, MCGIP_CALENDARHEADER, MCGIP_CALENDARBODY, MCGIP_CALENDARROW o MCGIP_CALENDARCELL, este miembro especifica el índice del calendario para el que se va a recuperar información. Para esas partes, debe ser un valor válido aunque solo haya un calendario que esté actualmente en el control.

iRow

Tipo: int

Si dwPart es MCGIP_CALENDARROW, especifica la fila para la que se va a devolver información.

iCol

Tipo: int

Si dwPart es MCGIP_CALENDARCELL, especifica la columna de la celda para la que se va a devolver información. El miembro iRow proporciona la fila de la celda para la que se va a devolver información.

bSelected

Tipo: BOOL

Si dwPart está MCGIP_CALENDARCELL, indica si la celda descrita por iRow e iCol está seleccionada actualmente.

stStart

Tipo: SYSTEMTIME

Devuelve la fecha de inicio especificada por iCalendar. Solo se usa cuando dwFlags contiene MCGIF_DATE.

stEnd

Tipo: SYSTEMTIME

Devuelve la fecha de finalización especificada por iCalendar. Solo se usa cuando dwFlags contiene MCGIF_DATE.

rc

Tipo: RECT

Devuelve el rectángulo del elemento especificado en dwPart. Establezca solo si dwFlags contiene MCGIF_RECT.

pszName

Tipo: PWSTR

Puntero a una cadena para la que cchName es la longitud. Establezca solo si dwFlags contiene MCGIF_NAME y solo para las siguientes partes, como se describe en el miembro dwPart .

  • MCGIP_CALENDAR: devuelve el texto de las fechas seleccionadas. En el caso de varias selecciones, devuelve la fecha al principio de la selección.
  • MCGIP_CALENDARCELL: devuelve el texto de la celda indicada por iRow e iCol, por ejemplo "11" si se especificó el día 11.
  • MCGIP_CALENDARHEADER: devuelve el texto de lo que dice en el encabezado del calendario, por ejemplo, "Julio de 2006".

cchName

Tipo: size_t

Longitud de pszName, en caracteres.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado commctrl.h