commctrl.h

Estructura MCGRDINFO

Definición

typedef struct tagMCGRDINFO {  
    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;
} MCGRDINFO, *PMCGRDINFO;

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

Descripción

cbSize

Tamaño de esta estructura, en bytes.

dwPart

La parte del control de calendario para la cual se está solicitando esta información. Uno de los valores siguientes:

Valor	Significado
MCGIP_CALENDARCONTROL	El control de calendario entero, que puede incluir hasta 12 calendarios.
MCGIP_NEXT	El botón "siguiente".
MCGIP_PREV	El botón "anterior".
MCGIP_FOOTER	El pié.
MCGIP_CALENDAR	Un calendario específico. Usado con iCalendar y pszName.
MCGIP_CALENDARHEADER	Cabecera de calendario. Usado con iCalendar y pszName.
MCGIP_CALENDARBODY	El cuerpo del calendario. Usado con iCalendar.
MCGIP_CALENDARROW	Una fila de calendario dada. Usado con iCalendar y iRow.
MCGIP_CALENDARCELL	Una celda de calendario dada. Usado con iCalendar, iRow, iCol, bSelected y pszName.

dwFlags

Indica qué información debe ser rellenada. Una combinación de uno o más de los siguientes valores:

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

iCalendar

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 está pidiendo información. Para esas partes, este debe ser un valor válido aunque actualmente sólo haya un calendario en el control.

iRow

Si dwPart es MCGIP_CALENDARROW, especifica la fila para la que se debe retornar la información.

iCol

Si dwPart es MCGIP_CALENDARCELL, especifica la columna de la celda para la que se debe retornar la información. El miembro iRow proporciona la fila de esa misma celda.

bSelected

Si dwPart es MCGIP_CALENDARCELL, indica si la celda determinada por iRow y iCol está actualmente seleccionada.

stStart

Devuelve la fecha de unicio especificada por iCalendar. Sólo se usa si dwFlags contiene MCGIF_DATE.

stEnd

Devuelve la fecha final especificada por iCalendar. Sólo se usa si dwFlags contiene MCGIF_DATE.

rc

Devuelve el rectángulo de la parte especificada en dwPart. Sólo se usa si dwFlags contiene MCGIF_RECT.

pszName

Puntero a una cadena de la que cchName es la longitud. Asignado sólo si dwFlags contiene MCGIF_NAME, y sólo para las siguientes partes, como se indica en el miembro dwPart:

MCGIP_CALENDAR: Devuelve el texto de las fechas seleccionadas. En el caso de selección múltiple, devuelve la fecha en el comienzo de la selección.
MCGIP_CALENDARCELL: Devuelve el texto de la celda determinada por iRow y iCol, por ejemplo "11" si se especificó el día once.
MCGIP_CALENDARHEADER: Devuelve el texto de la cabecera del calendario, por ejemplo "Julio, 2021".

cchName

Longitud de pszName en caracteres.