IConsole2：：SetStatusText 方法 (mmc.h)

IConsole2：：SetStatusText 方法可讓嵌入式管理單元變更狀態列中的文字。 請注意，這僅供 IComponent 的實例使用。

語法

HRESULT SetStatusText(
  [in] LPOLESTR pszStatusText
);

參數

[in] pszStatusText

Null 終止字串的指標，其中包含要顯示在狀態列中的文字。

傳回值

這個方法可以傳回下列其中一個值。

備註

狀態列有三個區段，由管道字元 (來分隔 |) 。 例如，將狀態欄中的文字設定為 “Left|Middle|Right“ 會將 「Left」 放在狀態列最左邊的區段、中間區段中的 「Middle」，以及最右邊區段中的 「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