MCGRIDINFO 結構 (commctrl.h)

包含行事曆控制項部分的相關資訊。

語法

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;

成員

cbSize

類型： UINT

這個結構的大小，以位元組為單位。

dwPart

類型： DWORD

要要求資訊的行事曆控制項部分。 下列其中一個值。

值	意義
MCGIP_CALENDARCONTROL	整個行事曆控制項，最多可包含 12 個行事曆。
MCGIP_NEXT	下一個按鈕。
MCGIP_PREV	上一個按鈕。
MCGIP_FOOTER	頁尾。
MCGIP_CALENDAR	一個特定的行事曆。 與 iCalendar 和 pszName搭配使用。
MCGIP_CALENDARHEADER	行事曆標頭。 與 iCalendar 和 pszName搭配使用。
MCGIP_CALENDARBODY	行事曆本文。 與 iCalendar搭配使用。
MCGIP_CALENDARROW	指定的行事歷數據列。 與 iCalendar 和 iRow搭配使用。
MCGIP_CALENDARCELL	指定的行事曆儲存格。 與 iCalendar、 iRow、 iCol、 bSelected 和 pszName搭配使用。

dwFlags

類型： DWORD

指出要填入的資訊。 下列一或多個值的組合。

值	意義
MCGIF_DATE	stStart 和 stEnd。
MCGIF_RECT	rc.
MCGIF_NAME	pszName。

iCalendar

類型： int

如果 dwPart 是MCGIP_CALENDAR、MCGIP_CALENDARHEADER、MCGIP_CALENDARBODY、MCGIP_CALENDARROW或MCGIP_CALENDARCELL，則此成員會指定要擷取資訊的行事曆索引。 對於這些部分，即使控制項中只有一個行事曆，這必須是有效的值。

iRow

類型： int

如果 dwPart 是MCGIP_CALENDARROW，請指定要傳回信息的資料列。

iCol

類型： int

如果 dwPart 是MCGIP_CALENDARCELL，請指定要傳回信息的儲存格資料行。 iRow成員會提供要傳回信息之儲存格的資料列。

bSelected

類型： BOOL

如果 dwPart 是MCGIP_CALENDARCELL，表示 iRow 和 iCol 所描述的儲存格目前是否已選取。

stStart

類型： SYSTEMTIME

傳回 iCalendar 所指定的開始日期。 只有在 dwFlags 包含MCGIF_DATE時才使用。

stEnd

類型： SYSTEMTIME

傳回 iCalendar 指定的結束日期。 只有在 dwFlags 包含MCGIF_DATE時才使用。

rc

類型： RECT

傳回 dwPart中指定的部分矩形。 只有在 dwFlags 包含MCGIF_RECT時才設定。

pszName

類型： PWSTR

cchName為長度的字串指標。 只有在 dwFlags 包含MCGIF_NAME，而且僅適用于下列部分，如 dwPart 成員中所述。

• MCGIP_CALENDAR：傳回所選日期的文字。 在多重選取的情況下，傳回選取範圍開頭的日期。
• MCGIP_CALENDARCELL：如果指定了第 11 天，則會傳回 iRow 和 iCol所指示儲存格的文字，例如 「11」。
• MCGIP_CALENDARHEADER：傳回行事曆標頭中顯示的內容文字，例如 「2006 年 7 月」。

cchName

類型： size_t

pszName的長度，以字元為單位。

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	commctrl.h