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
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