CProgressCtrl-Klasse

Artikel
02/26/2013

Stellt die Funktionalität des Windows-Common-Statusanzeige-Steuerelements bereit.

class CProgressCtrl : public CWnd

Mitglieder

Öffentliche Konstruktoren

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

Öffentliche Methoden

Name	Description
CProgressCtrl::Create	Erstellt ein und fügt es Statusanzeige-Steuerelement zu einem CProgressCtrl-Objekt.
CProgressCtrl::CreateEx	Erstellt ein Statussteuerelement mit den angegebenen Windows-erweitertenFormaten und fügt es zu einem CProgressCtrl-Objekt.
CProgressCtrl::GetBarColor	Ruft die Farbe der Statusanzeigeleiste für das aktuelle Statusanzeige-Steuerelement ab.
CProgressCtrl::GetBkColor	Ruft die Hintergrundfarbe der aktuellen Statusanzeige ab.
CProgressCtrl::GetPos	Ruft die aktuelle Position der Statusanzeige ab.
CProgressCtrl::GetRange	Ruft das niedrigere und die Untergrenze des Bereichs des Statusanzeige-Steuerelements ab.
CProgressCtrl::GetState	Ruft den Zustand des aktuellen Statusanzeige-Steuerelements ab.
CProgressCtrl::GetStep	Ruft die Schrittweite für die Statusanzeige des aktuellen Statusanzeige-Steuerelements ab.
CProgressCtrl::OffsetPos	Setzt die aktuelle Position eines Statusanzeige-Steuerelements vom angegebenen Inkrement und zeichnet die Leiste neu, um die neue Lage widerzuspiegeln.
CProgressCtrl::SetBarColor	Legt die Farbe der Statusanzeigeleiste im aktuellen Statusanzeige-Steuerelement fest.
CProgressCtrl::SetBkColor	Legt die Hintergrundfarbe der Statusanzeige fest.
CProgressCtrl::SetMarquee	Aktiviert oder deaktiviert Laufschriftmodus für das aktuelle Statusanzeige-Steuerelement.
CProgressCtrl::SetPos	Legt die aktuelle Position für ein Statusanzeige-Steuerelement fest und zeichnet die Leiste neu, um die neue Lage widerzuspiegeln.
CProgressCtrl::SetRange	Legt die minimalen und maximalen Bereiche für ein Statusanzeige-Steuerelement fest und zeichnet die Leiste neu, um die neuen Bereiche wiederzugeben.
CProgressCtrl::SetState	Legt den Zustand des aktuellen Statusanzeige-Steuerelements fest.
CProgressCtrl::SetStep	Gibt die Schrittweite für ein Statusanzeige-Steuerelement an.
CProgressCtrl::StepIt	Setzt die aktuelle Position für ein Statusanzeige-Steuerelement durch die Schrittweite (siehe SetStep) und zeichnet die Leiste neu, um die neue Lage widerzuspiegeln.

Hinweise

Ein Statusanzeige-Steuerelement ist ein Fenster, das eine Anwendung verwenden kann, um den Status eines längeren Vorgangs anzugeben.Es besteht aus einem Rechteck, das sich von links nach rechts gefüllt wird mit der Hervorhebungsfarbe des Systems Status eines Vorgangs.

Ein Statusanzeige-Steuerelement hat einen Bereich und eine aktuelle Position.Der Bereich stellt die gesamte Dauer des Vorgangs dar, und die aktuelle Position stellt den Status dar, den die Anwendung beim Abschließen des Vorgangs ausgeführt hat.Die Fensterprozedur verwendet den Bereich und die aktuelle Position, den Prozentsatz der Statusanzeige zu bestimmen, die mit der Hervorhebungsfarbe auszufüllen.Da die Bereichs- und Positionswerte als Zahlen mit Vorzeichen ausgedrückt werden, ist der mögliche Bereich von Werten der aktuellen Position von 2.147.483.648 bis 2.147.483.647 liegt.

Weitere Informationen zur Verwendung von CProgressCtrl, finden Sie unter Steuerelemente und Verwenden CProgressCtrl.