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