Klasse CMFCRibbonProgressBar

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Implementeert een besturingselement dat de voortgang van een langdurige bewerking visueel aangeeft.

Syntaxis

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Leden

Openbare constructors

Naam	Description
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Maakt en initialiseert een CMFCRibbonProgressBar object.

Openbare methoden

Naam	Description
CMFCRibbonProgressBar::GetPos	Retourneert de huidige voortgang.
CMFCRibbonProgressBar::GetRangeMax	Retourneert de maximumwaarde van het huidige bereik.
CMFCRibbonProgressBar::GetRangeMin	Retourneert de minimumwaarde van het huidige bereik.
CMFCRibbonProgressBar::GetRegularSize	Retourneert de normale grootte van het lintelement. (Overschrijft CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode	Hiermee geeft u op of de voortgangsbalk in oneindige modus werkt.
CMFCRibbonProgressBar::OnDraw	Aangeroepen door het framework om het lintelement te tekenen. (Overschrijft CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode	Hiermee stelt u de voortgangsbalk in voor gebruik in oneindige modus.
CMFCRibbonProgressBar::SetPos	Hiermee stelt u de huidige voortgang in.
CMFCRibbonProgressBar::SetRange	Hiermee stelt u de minimum- en maximumwaarden in.

Opmerkingen

Een CMFCRibbonProgressBar kan in twee modi werken: normaal en oneindig. In de normale modus wordt de voortgangsbalk van links naar rechts gevuld en wordt gestopt wanneer deze de maximumwaarde bereikt. In oneindige modus wordt de voortgangsbalk herhaaldelijk opgevuld van de minimumwaarde tot de maximumwaarde. U kunt oneindige modus gebruiken om aan te geven dat een bewerking wordt uitgevoerd, maar dat de voltooiingstijd onbekend is.

Example

In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonProgressBar klasse gebruikt. In het voorbeeld ziet u hoe u de voortgangsbalk instelt op werken in oneindige modus (waarbij de voltooiingstijd van een bewerking onbekend is), de minimum- en maximumwaarden voor de voortgangsbalk instelt en de huidige positie van de voortgangsbalk instelt. Dit codefragment maakt deel uit van het MS Office 2007 Demo-voorbeeld.

// 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);

Overnamehiërarchie

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Requirements

Koptekst: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

Maakt en initialiseert een CMFCRibbonProgressBar-object .

CMFCRibbonProgressBar();

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

Parameterwaarden

nID
[in] Hiermee geeft u de opdracht-id voor de voortgangsbalk van het lint.

nWidth
[in] Hiermee geeft u de breedte, in pixels, van de voortgangsbalk van het lint.

nHeight
[in] Hiermee geeft u de hoogte, in pixels, van de voortgangsbalk van het lint.

CMFCRibbonProgressBar::GetPos

Retourneert de huidige positie van de voortgangsbalk.

int GetPos () const;

Retourwaarde

Een waarde die de huidige positie van de voortgangsbalk aangeeft.

Opmerkingen

Het bereik dat wordt ingesteld, moet binnen het bereik vallen dat is opgegeven door de methode CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::GetRangeMax

Retourneert de huidige maximumwaarde van de voortgangsbalk.

int GetRangeMax() const;

Retourwaarde

De maximumwaarde van het huidige bereik.

Opmerkingen

CMFCRibbonProgressBar::GetRangeMin

Retourneert de huidige minimumbereikwaarde van de voortgangsbalk.

int GetRangeMin() const;

Retourwaarde

De minimumwaarde van het huidige bereik.

CMFCRibbonProgressBar::GetRegularSize

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

virtual CSize GetRegularSize(CDC* pDC);

Parameterwaarden

[in] Pdc

Retourwaarde

Opmerkingen

CMFCRibbonProgressBar::IsInfiniteMode

Hiermee geeft u op of de voortgangsbalk in oneindige modus werkt.

BOOL IsInfiniteMode() const;

Retourwaarde

WAAR als de voortgangsbalk zich in oneindige modus bevindt; anders, ONWAAR.

Opmerkingen

In oneindige modus vult de voortgangsbalk herhaaldelijk van de minimumwaarde tot de maximumwaarde op. U kunt oneindige modus gebruiken om aan te geven dat een bewerking wordt uitgevoerd, maar dat de voltooiingstijd onbekend is.

CMFCRibbonProgressBar::OnDraw

Zie de broncode in de map VC\atlmfc\src\mfc van uw Visual Studio-installatie voor meer informatie.

virtual void OnDraw(CDC* pDC);

Parameterwaarden

[in] Pdc

Opmerkingen

CMFCRibbonProgressBar::SetInfiniteMode

Hiermee stelt u de voortgangsbalk in voor gebruik in oneindige modus.

void SetInfiniteMode(BOOL bSet = TRUE);

Parameterwaarden

bSet
[in] TRUE om op te geven dat de voortgangsbalk zich in oneindige modus bevindt; anders, ONWAAR.

Opmerkingen

Als de voortgangsbalk zich in de oneindige modus bevindt, wordt de gebruiker meestal verteld dat er een bewerking wordt uitgevoerd, maar dat de voltooiingstijd onbekend is. De voortgangsbalk wordt dus herhaaldelijk gevuld van de minimumwaarde tot de maximumwaarde.

CMFCRibbonProgressBar::SetPos

Hiermee stelt u de huidige positie van de voortgangsbalk in.

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

Parameterwaarden

nPos
[in] Hiermee geeft u de positie op waarop de voortgangsbalk is ingesteld.

bRedraw
[in] Hiermee geeft u op of de voortgangsbalk opnieuw moet worden getekend.

Opmerkingen

Het bereik dat wordt ingesteld, moet binnen het bereik vallen dat is opgegeven door de methode CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::SetRange

Hiermee stelt u de minimum- en maximumwaarden voor de voortgangsbalk in.

void SetRange(
    int nMin,
    int nMax);

Parameterwaarden

Nmin
[in] Hiermee geeft u de minimumwaarde van het bereik.

nMax
[in] Hiermee geeft u de maximumwaarde van het bereik.

Opmerkingen

Gebruik deze methode om het bereik van de voortgangsbalk te definiëren door minimum- en maximumwaarden in te stellen.

Zie ook

Hiërarchiegrafiek
Klassen
Klasse CMFCRibbonBaseElement
CMFCRibbonBar-klasse