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:

ValorSignificado
MCGIP_CALENDARCONTROLEl control de calendario entero, que puede incluir hasta 12 calendarios.
MCGIP_NEXTEl botón "siguiente".
MCGIP_PREVEl botón "anterior".
MCGIP_FOOTEREl pié.
MCGIP_CALENDARUn calendario específico. Usado con iCalendar y pszName.
MCGIP_CALENDARHEADERCabecera de calendario. Usado con iCalendar y pszName.
MCGIP_CALENDARBODYEl cuerpo del calendario. Usado con iCalendar.
MCGIP_CALENDARROWUna fila de calendario dada. Usado con iCalendar y iRow.
MCGIP_CALENDARCELLUna 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:

ValorSignificado
MCGIF_DATEstStart y stEnd.
MCGIF_RECTrc.
MCGIF_NAMEpszName.
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.