MMC_LISTPAD_INFO 结构 (mmc.h)

MMC 1.1 中引入了MMC_LISTPAD_INFO结构。

MMC_LISTPAD_INFO结构由 IExtendTaskPad::GetListPadInfo 方法填充,为列表视图任务板指定以下信息:

语法

typedef struct _MMC_LISTPAD_INFO {
  LPOLESTR szTitle;
  LPOLESTR szButtonText;
  LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;

成员

szTitle

指向以 null 结尾的字符串的指针,该字符串包含位于列表控件正上方的文本。 如果列表包含打印机 () 或说明 (“选择打印机并单击要执行的操作”等,则此文本可以是列表控件中对象的标签,例如“打印机”。) 。

如果 szTitleNULL 或空,则不显示列表控件的标题。

请注意,szTitle 成员与 IExtendTaskPad::GetTitlepszTitle 参数不同。 IExtendTaskPad::GetTitle 方法返回整个任务板的标题,该任务板显示在任务板顶部,并显示在每个标准 MMC 任务板上。 MMC_LISTPAD_INFOszTitle 成员是列表控件的标签,仅显示在 MMC 列表视图任务板上。

szButtonText

指向以 null 结尾的字符串的指针,该字符串包含放置在位于列表控件正上方和 szTitle 文本右侧的按钮上的文本。

当用户在任务板上单击此按钮时,MMC 将调用管理单元的 IExtendTaskPad::TaskNotify 方法,并将 nCommandID 中指定的值作为 arg 参数中的 VARIANT 结构传递。 传递给 TaskNotifyVARIANT成员设置为VT_I4lVal 成员包含命令 ID。

若要使按钮显示为不带文本,请将 szButtonText 设置为空字符串。

若要隐藏此按钮以显示在任务板上,请将 szButtonText 设置为 NULL

nCommandID

用作 szButtonText 指定的按钮的标识符的值。 建议将此值设置为每个任务板的唯一值,以帮助识别发送按钮单击通知的任务板。

当用户单击此按钮时,MMC 将调用管理单元的 IExtendTaskPad::TaskNotify 方法,并将此值作为 arg 参数中的 VARIANT 传递。

如果 szButtonTextNULL,则忽略此值。

注解

使用 COM API 函数 CoTaskMemAlloc (分配 szTitleszButtonText 字符串,否则等效) 和 MMC 将释放它。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
标头 mmc.h

另请参阅

IExtendTaskPad::GetListPadInfo

IExtendTaskPad::TaskNotify