MMC_LISTPAD_INFO 结构 (mmc.h)
MMC 1.1 中引入了MMC_LISTPAD_INFO结构。
MMC_LISTPAD_INFO结构由 IExtendTaskPad::GetListPadInfo 方法填充,为列表视图任务板指定以下信息:
- 列表控件的标题文本
- 可选按钮的文本
- 单击该按钮时传递给 IExtendTaskPad::TaskNotify 的命令 ID。
语法
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
成员
szTitle
指向以 null 结尾的字符串的指针,该字符串包含位于列表控件正上方的文本。 如果列表包含打印机 () 或说明 (“选择打印机并单击要执行的操作”等,则此文本可以是列表控件中对象的标签,例如“打印机”。) 。
如果 szTitle 为 NULL 或空,则不显示列表控件的标题。
请注意,szTitle 成员与 IExtendTaskPad::GetTitle 的 pszTitle 参数不同。 IExtendTaskPad::GetTitle 方法返回整个任务板的标题,该任务板显示在任务板顶部,并显示在每个标准 MMC 任务板上。 MMC_LISTPAD_INFO 的 szTitle 成员是列表控件的标签,仅显示在 MMC 列表视图任务板上。
szButtonText
指向以 null 结尾的字符串的指针,该字符串包含放置在位于列表控件正上方和 szTitle 文本右侧的按钮上的文本。
当用户在任务板上单击此按钮时,MMC 将调用管理单元的 IExtendTaskPad::TaskNotify 方法,并将 nCommandID 中指定的值作为 arg 参数中的 VARIANT 结构传递。 传递给 TaskNotify 的 VARIANT成员设置为VT_I4,lVal 成员包含命令 ID。
若要使按钮显示为不带文本,请将 szButtonText 设置为空字符串。
若要隐藏此按钮以显示在任务板上,请将 szButtonText 设置为 NULL。
nCommandID
用作 szButtonText 指定的按钮的标识符的值。 建议将此值设置为每个任务板的唯一值,以帮助识别发送按钮单击通知的任务板。
当用户单击此按钮时,MMC 将调用管理单元的 IExtendTaskPad::TaskNotify 方法,并将此值作为 arg 参数中的 VARIANT 传递。
如果 szButtonText 为 NULL,则忽略此值。
注解
使用 COM API 函数 CoTaskMemAlloc (分配 szTitle 和 szButtonText 字符串,否则等效) 和 MMC 将释放它。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
标头 | mmc.h |