Freigeben über


IConsole2::SetStatusText-Methode (mmc.h)

Die IConsole2::SetStatusText-Methode ermöglicht es dem Snap-In, den Text in der status leiste zu ändern. Beachten Sie, dass dies nur von Instanzen von IComponent verwendet wird.

Syntax

HRESULT SetStatusText(
  [in] LPOLESTR pszStatusText
);

Parameter

[in] pszStatusText

Ein Zeiger auf eine NULL-endende Zeichenfolge, die Text enthält, der in der status leiste angezeigt werden soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Der status Balken weist drei Abschnitte auf, die durch das Strichzeichen (|) abgegrenzt werden. Legen Sie beispielsweise den Text in der status leiste auf "Links| Mitte| Rechts" platziert "Links" im äußersten linken Abschnitt der status leiste, "Mitte" im mittleren Abschnitt und "Rechts" im äußersten rechten Abschnitt.

Wenn mehr als drei Felder abgegrenzt werden (d. h. es gibt mehr als zwei Pipes), wird alles weggelassen, was im vierten und höheren Feld platziert würde.

Darüber hinaus ist der mittlere Abschnitt so konzipiert, dass er als Statusanzeige fungiert. Diese Funktion wird aufgerufen, indem das Zeichen "%" als erstes Zeichen, gefolgt von einer Zahl zwischen 0 und 100, in den mittleren Abschnitt übergeben wird. Anstelle von Text zeigt dieser Abschnitt dann eine Statusanzeige an, die 0 bis 100 Prozent abgeschlossen ist. Wenn Sie z. B. "Fertig|%75" übergeben, wird im linken Abschnitt "Fertig" und im mittleren Abschnitt ein Statusbalken zu 75 % abgeschlossen.

Um eine Zeichenfolge anzuzeigen, die mit '%' im mittleren Abschnitt der status leiste beginnt, beginnen Sie die Zeichenfolge dann mit '%%'. Dies bewirkt, dass im mittleren Abschnitt Text angezeigt wird und der erste "%" entfernt wird. Beispiel: "Heute ist|%%Mittwoch%" ergibt den linken Abschnitt, der "Heute ist" enthält, und den mittleren Abschnitt, der "%Wednesday%" enthält. Wenn im mittleren Abschnitt nach "%" eine ungültige Zahl oder ein nicht numerischer Text eingegeben wird, ist der mittlere Abschnitt leer. Wenn ein %-Zeichen das einzige Zeichen im Abschnitt ist, wird es als Text angezeigt.

Diese Methode sollte von einem IConsole2-Schnittstellenzeiger aufgerufen werden, der über IComponent abgerufen wird.

Nur das Snap-In, das das aktuell ausgewählte Bereichselement besitzt, kann den status Balkentext ändern.

In MMC Version 1.1 und höher verfügt jedes untergeordnete MDI-Fenster (Multiple-Document Interface) über einen status Balken.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h
DLL Mmcndmgr.dll

Weitere Informationen

IConsole2