Klasa CMFCRibbonProgressBar

Implementuje kontrolkę, która wizualnie wskazuje postęp długotrwałej operacji.

Składnia

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Tworzy i inicjuje CMFCRibbonProgressBar obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMFCRibbonProgressBar::GetPos	Zwraca bieżący postęp.
CMFCRibbonProgressBar::GetRangeMax	Zwraca maksymalną wartość bieżącego zakresu.
CMFCRibbonProgressBar::GetRangeMin	Zwraca minimalną wartość bieżącego zakresu.
CMFCRibbonProgressBar::GetRegularSize	Zwraca zwykły rozmiar elementu wstążki. (Przesłonięcia) CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode	Określa, czy pasek postępu działa w trybie nieskończonym.
CMFCRibbonProgressBar::OnDraw	Wywoływana przez strukturę w celu narysowania elementu wstążki. (Przesłonięcia) CMFCRibbonBaseElement::OnDraw.
CMFCRibbonProgressBar::SetInfiniteMode	Ustawia pasek postępu, aby działał w trybie nieskończonym.
CMFCRibbonProgressBar::SetPos	Ustawia bieżący postęp.
CMFCRibbonProgressBar::SetRange	Ustawia wartości minimalne i maksymalne.

Uwagi

Element CMFCRibbonProgressBar może działać w dwóch trybach: regularnych i nieskończonych. W trybie regularnym pasek postępu jest wypełniany od lewej do prawej i zatrzymuje się, gdy osiągnie maksymalną wartość. W trybie nieskończonym pasek postępu jest wielokrotnie wypełniany z wartości minimalnej do wartości maksymalnej. Możesz użyć trybu nieskończonego, aby wskazać, że operacja trwa, ale czas ukończenia jest nieznany.

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonProgressBar klasie . W przykładzie pokazano, jak ustawić pasek postępu, aby działał w trybie nieskończonym (gdzie czas ukończenia operacji jest nieznany), ustawić minimalne i maksymalne wartości paska postępu i ustawić bieżące położenie paska postępu. Ten fragment kodu jest częścią przykładu pokazowego pakietu MS Office 2007.

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

Hierarchia dziedziczenia

Obiekt CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Wymagania

Nagłówek: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

Tworzy i inicjuje obiekt CMFCRibbonProgressBar .

CMFCRibbonProgressBar();

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

Parametry

Nid
[in] Określa identyfikator polecenia paska postępu wstążki.

nWidth
[in] Określa szerokość paska postępu wstążki w pikselach.

nHeight
[in] Określa wysokość paska postępu wstążki w pikselach.

CMFCRibbonProgressBar::GetPos

Zwraca bieżącą pozycję paska postępu.

int GetPos () const;

Wartość zwracana

Wartość reprezentująca bieżącą pozycję paska postępu.

Uwagi

Ustawiany zakres musi należeć do zakresu określonego przez metodę CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::GetRangeMax

Zwraca bieżącą wartość maksymalną paska postępu.

int GetRangeMax() const;

Wartość zwracana

Maksymalna wartość bieżącego zakresu.

Uwagi

CMFCRibbonProgressBar::GetRangeMin

Zwraca bieżącą wartość zakresu minimalnego paska postępu.

int GetRangeMin() const;

Wartość zwracana

Minimalna wartość bieżącego zakresu.

CMFCRibbonProgressBar::GetRegularSize

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

virtual CSize GetRegularSize(CDC* pDC);

Parametry

[in] PDC

Wartość zwracana

Uwagi

CMFCRibbonProgressBar::IsInfiniteMode

Określa, czy pasek postępu działa w trybie nieskończonym.

BOOL IsInfiniteMode() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli pasek postępu jest w trybie nieskończonym; w przeciwnym razie, FAŁSZ.

Uwagi

W trybie nieskończonym pasek postępu wypełnia się wielokrotnie z wartości minimalnej do maksymalnej. Możesz użyć trybu nieskończonego, aby wskazać, że operacja trwa, ale czas ukończenia jest nieznany.

CMFCRibbonProgressBar::OnDraw

Aby uzyskać więcej informacji, zobacz kod źródłowy znajdujący się w folderze VC\atlmfc\src\mfc instalacji programu Visual Studio.

virtual void OnDraw(CDC* pDC);

Parametry

[in] PDC

Uwagi

CMFCRibbonProgressBar::SetInfiniteMode

Ustawia pasek postępu, aby działał w trybie nieskończonym.

void SetInfiniteMode(BOOL bSet = TRUE);

Parametry

Zestaw bSet
[in] WARTOŚĆ TRUE określająca, że pasek postępu jest w trybie nieskończonym; w przeciwnym razie, FAŁSZ.

Uwagi

Zazwyczaj jeśli pasek postępu jest w trybie nieskończonym, informuje użytkownika, że operacja trwa, ale czas ukończenia jest nieznany. W związku z tym pasek postępu wypełnia się wielokrotnie z wartości minimalnej do wartości maksymalnej.

CMFCRibbonProgressBar::SetPos

Ustawia bieżące położenie paska postępu.

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

Parametry

nPos
[in] Określa położenie, do którego ustawiono pasek postępu.

bRedraw
[in] Określa, czy pasek postępu ma być ponownie rysowane.

Uwagi

Ustawiany zakres musi należeć do zakresu określonego przez metodę CMFCRibbonProgressBar::SetRange .

CMFCRibbonProgressBar::SetRange

Ustawia wartości minimalne i maksymalne dla paska postępu.

void SetRange(
    int nMin,
    int nMax);

Parametry

nMin
[in] Określa minimalną wartość zakresu.

nMax
[in] Określa maksymalną wartość zakresu.

Uwagi

Użyj tej metody, aby zdefiniować zakres paska postępu, ustawiając wartości minimalne i maksymalne.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCRibbonBaseElement
Klasa CMFCRibbonBar