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：返回 iRow 和 iCol 指示的单元格的文本，例如，如果指定了第 11 天，则返回“11”。
• MCGIP_CALENDARHEADER：返回日历标题中的内容的文本，例如“2006 年 7 月”。

cchName

类型： size_t

pszName 的长度（以字符为单位）。

要求

最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	commctrl.h