IConsole2：：SetStatusText 方法 (mmc.h)

IConsole2：：SetStatusText 方法使管理单元能够更改状态栏中的文本。 请注意，这仅由 IComponent 实例使用。

语法

HRESULT SetStatusText(
  [in] LPOLESTR pszStatusText
);

参数

[in] pszStatusText

指向以 null 结尾的字符串的指针，该字符串包含要显示在状态栏中的文本。

返回值

此方法可以返回其中一个值。

注解

状态栏有三个部分，这些部分由管道字符 (|) 。 例如，将状态栏中的文本设置为“Left|中间 |右“将”Left“放在状态栏的最左侧，”中间“放在中间部分，将”Right“放在最右侧。

如果多于三个字段 (也就是说，) 有两个以上的管道，则省略将放置在第四个和更高字段的所有字段。

此外，中间部分旨在用作进度栏。 通过将“%”字符作为第一个字符（后跟 0 到 100 之间的数字）传递到中间部分来调用此功能。 然后，本部分显示零到 100% 完成的进度栏，而不是文本。 例如，传递“Done|%75”在左侧部分放置“Done”，将进度栏置于中间部分完成 75%。

若要在状态栏中间部分显示以“%”开头的字符串，请以“%%”开头。 这会导致中间部分显示文本并删除第一个“%”。 例如：“Today is|%%wednesday%”会导致包含“Today is”的左节和包含“%wednesday%”的中间部分。 如果在中间部分的“%”后输入了无效的数字或非数字文本，则中间部分为空。 如果“%”是节中唯一的字符，则它将显示为文本。

应从通过 IComponent 获取的 IConsole2 接口指针调用此方法。

只有拥有当前所选作用域项的管理单元才能更改状态栏文本。

在 MMC 版本 1.1 及更高版本中，MDI) 子窗口 (每个多文档接口都有一个状态栏。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	mmc.h
DLL	Mmcndmgr.dll

另请参阅

IConsole2