CStatusBar-Klasse

Artikel
06/10/2015

Eine Steuerleiste mit einer Zeile von Textausgabebereichen oder "von Indikatoren".

class CStatusBar : public CControlBar

Mitglieder

Öffentliche Konstruktoren

Name	Description
CStatusBar::CStatusBar	Erstellt ein CStatusBar-Objekt.

Öffentliche Methoden

Name	Description
CStatusBar::CommandToIndex	Ruft Index für eine angegebene Indikator ID ab
CStatusBar::Create	Erstellt die Statusleiste, fügt sie dem CStatusBar-Objekt an und legt die ursprüngliche Schriftart- und Leistehöhe fest.
CStatusBar::CreateEx	Erstellt ein Objekt CStatusBar mit zusätzlichen Formaten für das eingebettete CStatusBarCtrl-Objekt.
CStatusBar::DrawItem	Aufgerufen, wenn ein visueller Aspekt eines Ownerdrawnstatusbar-steuerelements ändert.
CStatusBar::GetItemID	Ruft Indikator ID für einen angegebenen Index ab.
CStatusBar::GetItemRect	Ruft Anzeigenrechteck für einen angegebenen Index ab.
CStatusBar::GetPaneInfo	Ruft Indikator-ID, -Format und - breite für einen angegebenen Index ab.
CStatusBar::GetPaneStyle	Ruft Indikatorformat für einen angegebenen Index ab.
CStatusBar::GetPaneText	Ruft Indikatortext für einen angegebenen Index ab.
CStatusBar::GetStatusBarCtrl	Ermöglicht Zugriff auf die zugrunde liegenden allgemeine Steuerelemente.
CStatusBar::SetIndicators	Legt Indikator IDs fest.
CStatusBar::SetPaneInfo	Legt Indikator-ID, -Format und - breite für einen angegebenen Index fest.
CStatusBar::SetPaneStyle	Legt Indikatorformat für einen angegebenen Index fest.
CStatusBar::SetPaneText	Legt Indikatortext für einen angegebenen Index fest.

Hinweise

Die Ausgabebereiche werden häufig als Meldungszeilen und als Statusanzeigen verwendet. Beispiele sind die Menü HilfeMeldung Zeilen, die den ausgewählten kurz Menübefehl für und die Indikatoren, die den Status ROLLENs anzeigen, NUM und andere verschlüsselt.

CStatusBar::GetStatusBarCtrl, eine Memberfunktion, die MFC 4.0 neu ist, ermöglicht es Ihnen, die Unterstützung des allgemeinen Windows-Steuerelements für Statusleistenanpassung und -zusätzliche Funktionen zu nutzen. CStatusBar-Memberfunktionen geben Sie den Großteil der Funktionalität der allgemeinen Windows-Steuerelemente; Wenn Sie jedoch GetStatusBarCtrl aufrufen, können Sie den Statusleisten noch mehr der Eigenschaften einer Windows 95/98-Statusleiste geben. Wenn Sie GetStatusBarCtrl aufrufen, gibt es einen Verweis auf ein Objekt CStatusBarCtrl zurück. Siehe CStatusBarCtrl weitere Informationen zum Entwerfen von Symbolleisten mithilfe der allgemeinen Windows-Steuerelemente. Weitere allgemeine Informationen über allgemeine Steuerelemente finden Sie unter Allgemeine Steuerelemente in Windows SDK.

Das Framework speichert Indikatorinformationen in einem Array mit dem äußersten linken Indikator an Position 0. Wenn Sie eine Statusleiste erstellen, verwenden Sie ein Array Zeichenfolge IDs, die das Framework mit den entsprechenden Indikatoren zuordnet. Sie können entweder Zeichenfolgen-ID oder einen Index dann verwenden, um auf einen Indikator zuzugreifen.

Standardmäßig ist der erste Indikator "Gummiband": er nimmt die Statusleistenlänge auf, der nicht von anderen Indikatorbereiche verwendet werden, damit die anderen Bereiche rechtsbündig ausgerichtet sind.

Um eine Statusleiste zu erstellen, führen Sie folgende Schritte aus:

Erstellen Sie das CStatusBar-Objekt.
Rufen Sie die Funktion Erstellen Sie (oder CreateEx) auf, um das Statusleistenfenster zu erstellen und auf den CStatusBar-Objekt anzufügen.
Rufen Sie auf, um SetIndicators Zeichenfolgen-ID mit jedem Indikator zuzuordnen.

Es gibt drei Möglichkeiten, den Text in einem Statusleistenbereich zu aktualisieren: