CMFCRibbonProgressBar-Klasse

Implementiert ein Steuerelement, das den Fortschritt einer längeren Operation visuell darstellt.

Syntax

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Member

Öffentliche Konstruktoren

Name Beschreibung
CMFCRibbonProgressBar::CMFCRibbonProgressBar Erstellt und initialisiert ein CMFCRibbonProgressBar-Objekt.

Öffentliche Methoden

Name Beschreibung
CMFCRibbonProgressBar::GetPos Gibt den aktuellen Fortschritt zurück.
CMFCRibbonProgressBar::GetRangeMax Gibt den Maximalwert des aktuellen Bereichs zurück.
CMFCRibbonProgressBar::GetRangeMin Gibt den Minimalwert des aktuellen Bereichs zurück.
CMFCRibbonProgressBar::GetRegularSize Gibt die reguläre Größe des Menübandelements zurück. (Außerkraftsetzungen CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode Gibt an, ob die Statusanzeige im unendlichen Modus funktioniert.
CMFCRibbonProgressBar::OnDraw Wird vom Framework aufgerufen, um das Menübandelement zu zeichnen. (Außerkraftsetzungen CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode Legt die Statusanzeige so fest, dass sie im unendlichen Modus funktioniert.
CMFCRibbonProgressBar::SetPos Legt den aktuellen Fortschritt fest.
CMFCRibbonProgressBar::SetRange Legt die Mindest- und Höchstwerte fest.

Hinweise

Ein CMFCRibbonProgressBar kann in zwei Modi ausgeführt werden: normal und unendlich. Im regulären Modus wird die Statusanzeige von links nach rechts gefüllt und hält an, wenn der Maximalwert erreicht wird. Im Unendlichen Modus wird die Statusanzeige wiederholt vom Minimalwert bis zum Maximalwert gefüllt. Sie können den unendlichen Modus verwenden, um anzugeben, dass ein Vorgang ausgeführt wird, aber dass die Fertigstellungszeit unbekannt ist.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung verschiedener Methoden in der CMFCRibbonProgressBar -Klasse. Das Beispiel zeigt, wie die Statusanzeige im unendlichen Modus funktioniert (wobei die Fertigstellungszeit eines Vorgangs unbekannt ist), die Minimal- und Höchstwerte für die Statusanzeige festlegen und die aktuelle Position der Statusanzeige festlegen. Dieser Codeausschnitt ist Teil des MS Office 2007-Demobeispiels.

// int cxProgress
// BOOL m_bInfiniteProgressMode
CMFCRibbonProgressBar *pProgressBar = new CMFCRibbonProgressBar(ID_STATUSBAR_PROGRESS, cxProgress);

pProgressBar->SetInfiniteMode(m_bInfiniteProgressMode);
pProgressBar->SetRange(0, 200);
pProgressBar->SetPos(200, true);

Vererbungshierarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Anforderungen

Header: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

Erstellt und initialisiert ein CMFCRibbonProgressBar -Objekt.

CMFCRibbonProgressBar();

CMFCRibbonProgressBar(
    UINT nID,
    int nWidth = 90,
    int nHeight = 22);

Parameter

Nid
[in] Gibt die Befehls-ID für die Statusleiste des Menübands an.

nWidth
[in] Gibt die Breite der Statusleiste des Menübands in Pixel an.

nHeight
[in] Gibt die Höhe der Statusleiste des Menübands in Pixel an.

CMFCRibbonProgressBar::GetPos

Gibt die aktuelle Position der Statusanzeige zurück.

int GetPos () const;

Rückgabewert

Ein Wert, der die aktuelle Position der Statusanzeige darstellt.

Hinweise

Der festgelegte Bereich muss sich innerhalb des bereichs befinden, der von der CMFCRibbonProgressBar::SetRange-Methode angegeben wird.

CMFCRibbonProgressBar::GetRangeMax

Gibt den aktuellen Maximalwert der Statusleiste zurück.

int GetRangeMax() const;

Rückgabewert

Der Maximalwert des aktuellen Bereichs.

Hinweise

CMFCRibbonProgressBar::GetRangeMin

Gibt den aktuellen Minimalbereichswert der Statusanzeige zurück.

int GetRangeMin() const;

Rückgabewert

Der Minimalwert des aktuellen Bereichs.

CMFCRibbonProgressBar::GetRegularSize

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual CSize GetRegularSize(CDC* pDC);

Parameter

[in] pDC

Rückgabewert

Bemerkungen

CMFCRibbonProgressBar::IsInfiniteMode

Gibt an, ob die Statusanzeige im unendlichen Modus funktioniert.

BOOL IsInfiniteMode() const;

Rückgabewert

TRUE, wenn sich die Statusanzeige im unendlichen Modus befindet; andernfalls FALSE.

Hinweise

Im Unendlichen Modus füllt sich die Statusleiste wiederholt vom Minimalwert bis zum Maximalwert. Sie können den unendlichen Modus verwenden, um anzugeben, dass ein Vorgang ausgeführt wird, aber dass die Fertigstellungszeit unbekannt ist.

CMFCRibbonProgressBar::OnDraw

Ausführliche Informationen finden Sie im Quellcode des Ordners VC\atlmfc\src\mfc der Visual Studio-Installation.

virtual void OnDraw(CDC* pDC);

Parameter

[in] pDC

Hinweise

CMFCRibbonProgressBar::SetInfiniteMode

Legt die Statusanzeige so fest, dass sie im unendlichen Modus funktioniert.

void SetInfiniteMode(BOOL bSet = TRUE);

Parameter

bSet
[in] TRUE, um anzugeben, dass sich die Statusanzeige im unendlichen Modus befindet; andernfalls FALSE.

Hinweise

Wenn sich die Statusanzeige in der Regel im unendlichen Modus befindet, wird dem Benutzer mitgeteilt, dass ein Vorgang ausgeführt wird, die Fertigstellungszeit aber unbekannt ist. Daher füllt sich die Statusanzeige wiederholt vom Minimalwert bis zum Maximalwert.

CMFCRibbonProgressBar::SetPos

Legt die aktuelle Position der Statusanzeige fest.

void SetPos(
    int nPos,
    BOOL bRedraw = TRUE);

Parameter

nPos
[in] Gibt die Position an, an der die Statusanzeige festgelegt ist.

bRedraw
[in] Gibt an, ob die Statusanzeige neu gezeichnet werden soll.

Hinweise

Der festgelegte Bereich muss sich innerhalb des bereichs befinden, der von der CMFCRibbonProgressBar::SetRange-Methode angegeben wird.

CMFCRibbonProgressBar::SetRange

Legt die Mindest- und Höchstwerte für die Statusanzeige fest.

void SetRange(
    int nMin,
    int nMax);

Parameter

nMin
[in] Gibt den Minimalwert des Bereichs an.

nMax
[in] Gibt den Maximalwert des Bereichs an.

Hinweise

Verwenden Sie diese Methode, um den Bereich der Statusanzeige zu definieren, indem Sie Mindest- und Höchstwerte festlegen.

Siehe auch

Hierarchiediagramm
Klassen
CMFCRibbonBaseElement-Klasse
CMFCRibbonBar-Klasse