MCGRIDINFO-Struktur (commctrl.h)

Enthält Informationen zu einem Teil eines Kalendersteuerelements.

Syntax

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;

Member

cbSize

Typ: UINT

Größe dieser Struktur in Bytes.

dwPart

Typ: DWORD

Der Teil des Kalendersteuerelements, für den Informationen angefordert werden. Einer der folgenden Werte.

Wert	Bedeutung
MCGIP_CALENDARCONTROL	Das gesamte Kalendersteuerelement, das bis zu 12 Kalender enthalten kann.
MCGIP_NEXT	Die nächste Schaltfläche.
MCGIP_PREV	Die vorherige Schaltfläche.
MCGIP_FOOTER	Die Fußzeile.
MCGIP_CALENDAR	Ein bestimmter Kalender. Wird mit iCalendar und pszName verwendet.
MCGIP_CALENDARHEADER	Kalenderheader. Wird mit iCalendar und pszName verwendet.
MCGIP_CALENDARBODY	Kalendertext. Wird mit iCalendar verwendet.
MCGIP_CALENDARROW	Eine angegebene Kalenderzeile. Wird mit iCalendar und iRow verwendet.
MCGIP_CALENDARCELL	Eine angegebene Kalenderzelle. Wird mit iCalendar, iRow, iCol, bSelected und pszName verwendet.

dwFlags

Typ: DWORD

Gibt an, welche Informationen ausgefüllt werden sollen. Eine Kombination aus einem oder mehreren der folgenden Werte.

Wert	Bedeutung
MCGIF_DATE	stStart und stEnd.
MCGIF_RECT	rc.
MCGIF_NAME	pszName.

iCalendar

Typ: int

Wenn dwPart MCGIP_CALENDAR, MCGIP_CALENDARHEADER, MCGIP_CALENDARBODY, MCGIP_CALENDARROW oder MCGIP_CALENDARCELL ist, gibt dieses Element den Index des Kalenders an, für den Informationen abgerufen werden sollen. Für diese Teile muss dies ein gültiger Wert sein, auch wenn nur ein Kalender vorhanden ist, der sich derzeit im Steuerelement befindet.

iRow

Typ: int

Wenn dwPart MCGIP_CALENDARROW ist, gibt die Zeile an, für die Informationen zurückgegeben werden sollen.

iCol

Typ: int

Wenn dwPart MCGIP_CALENDARCELL ist, gibt die Spalte der Zelle an, für die Informationen zurückgegeben werden sollen. Das iRow-Element stellt die Zeile der Zelle bereit, für die Informationen zurückgegeben werden sollen.

bSelected

Typ: BOOL

Wenn dwPart MCGIP_CALENDARCELL ist, gibt an, ob die von iRow und iCol beschriebene Zelle derzeit ausgewählt ist.

stStart

Typ: SYSTEMTIME

Gibt das von iCalendar angegebene Startdatum zurück. Wird nur verwendet, wenn dwFlags MCGIF_DATE enthält.

stEnd

Typ: SYSTEMTIME

Gibt das von iCalendar angegebene Enddatum zurück. Wird nur verwendet, wenn dwFlags MCGIF_DATE enthält.

rc

Typ: RECT

Gibt das Rechteck des in dwPart angegebenen Teils zurück. Wird nur festgelegt, wenn dwFlags MCGIF_RECT enthält.

pszName

Typ: PWSTR

Zeiger auf eine Zeichenfolge, für die cchName die Länge ist. Legen Sie nur fest, wenn dwFlags MCGIF_NAME enthält, und nur für die folgenden Teile, wie im dwPart-Element beschrieben.

• MCGIP_CALENDAR: Gibt den Text der ausgewählten Datumsangaben zurück. Bei mehrfacher Auswahl gibt das Datum am Anfang der Auswahl zurück.
• MCGIP_CALENDARCELL: Gibt den Text der Durch iRow und iCol angegebenen Zelle für instance "11" zurück, wenn der 11. Tag angegeben wurde.
• MCGIP_CALENDARHEADER: Gibt für instance "Juli 2006" den Text in der Kalenderüberschrift zurück.

cchName

Typ: size_t

Länge von pszName in Zeichen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	commctrl.h