CMFCRibbonProgressBar – třída
Implementuje ovládací prvek, který vizuálně označuje průběh zdlouhavé operace.
Syntaxe
class CMFCRibbonProgressBar : public CMFCRibbonBaseElement
Členové
Veřejné konstruktory
| Název | Popis |
|---|---|
| CMFCRibbonProgressBar::CMFCRibbonProgressBar | Vytvoří a inicializuje CMFCRibbonProgressBar objekt. |
Veřejné metody
| Název | Popis |
|---|---|
| CMFCRibbonProgressBar::GetPos | Vrátí aktuální průběh. |
| CMFCRibbonProgressBar::GetRangeMax | Vrátí maximální hodnotu aktuálního rozsahu. |
| CMFCRibbonProgressBar::GetRangeMin | Vrátí minimální hodnotu aktuálního rozsahu. |
| CMFCRibbonProgressBar::GetRegularSize | Vrátí běžnou velikost prvku pásu karet. (Přepsání CMFCRibbonBaseElement::GetRegularSize.) |
| CMFCRibbonProgressBar::IsInfiniteMode | Určuje, jestli indikátor průběhu pracuje v nekonečném režimu. |
| CMFCRibbonProgressBar::OnDraw | Volá se rozhraním pro kreslení prvku pásu karet. (Přepsání CMFCRibbonBaseElement::OnDraw.) |
| CMFCRibbonProgressBar::SetInfiniteMode | Nastaví indikátor průběhu tak, aby fungoval v nekonečném režimu. |
| CMFCRibbonProgressBar::SetPos | Nastaví aktuální průběh. |
| CMFCRibbonProgressBar::SetRange | Nastaví minimální a maximální hodnoty. |
Poznámky
A CMFCRibbonProgressBar může pracovat ve dvou režimech: normální a nekonečné. V normálním režimu se indikátor průběhu vyplní zleva doprava a zastaví se, když dosáhne maximální hodnoty. V nekonečném režimu se indikátor průběhu opakovaně vyplní z minimální hodnoty na maximální hodnotu. Můžete použít nekonečný režim k označení, že operace probíhá, ale že čas dokončení je neznámý.
Příklad
Následující příklad ukazuje, jak používat různé metody ve CMFCRibbonProgressBar třídě. Příklad ukazuje, jak nastavit indikátor průběhu tak, aby fungoval v nekonečném režimu (kde je čas dokončení operace neznámý), nastavte minimální a maximální hodnoty indikátoru průběhu a nastavte aktuální pozici indikátoru průběhu. Tento fragment kódu je součástí ukázky MS Office 2007 Demo.
// 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);
Hierarchie dědičnosti
Požadavky
Hlavička: afxRibbonProgressBar.h
CMFCRibbonProgressBar::CMFCRibbonProgressBar
Vytvoří a inicializuje CMFCRibbonProgressBar objektu.
CMFCRibbonProgressBar();
CMFCRibbonProgressBar(
UINT nID,
int nWidth = 90,
int nHeight = 22);
Parametry
Nid
[v] Určuje ID příkazu pro indikátor průběhu pásu karet.
nWidth
[v] Určuje šířku pruhu průběhu pásu karet v pixelech.
nHeight
[v] Určuje výšku indikátoru průběhu pásu karet v pixelech.
CMFCRibbonProgressBar::GetPos
Vrátí aktuální pozici indikátoru průběhu.
int GetPos () const;
Návratová hodnota
Hodnota představující aktuální pozici indikátoru průběhu.
Poznámky
Rozsah, který se nastavuje, musí být v rozsahu určeném CMFCRibbonProgressBar::SetRange metoda.
CMFCRibbonProgressBar::GetRangeMax
Vrátí aktuální maximální hodnotu indikátoru průběhu.
int GetRangeMax() const;
Návratová hodnota
Maximální hodnota aktuálního rozsahu.
Poznámky
CMFCRibbonProgressBar::GetRangeMin
Vrátí aktuální minimální hodnotu rozsahu indikátoru průběhu.
int GetRangeMin() const;
Návratová hodnota
Minimální hodnota aktuálního rozsahu.
CMFCRibbonProgressBar::GetRegularSize
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
virtual CSize GetRegularSize(CDC* pDC);
Parametry
[v] pDC
Návratová hodnota
Poznámky
CMFCRibbonProgressBar::IsInfiniteMode
Určuje, jestli indikátor průběhu pracuje v nekonečném režimu.
BOOL IsInfiniteMode() const;
Návratová hodnota
TRUE, pokud indikátor průběhu je v nekonečném režimu; jinak NEPRAVDA.
Poznámky
V nekonečném režimu se indikátor průběhu opakovaně vyplní z minimální hodnoty na maximální hodnotu. Můžete použít nekonečný režim k označení, že operace probíhá, ale že čas dokončení je neznámý.
CMFCRibbonProgressBar::OnDraw
Další podrobnosti najdete ve zdrojovém kódu ve složce VC\atlmfc\src\mfc instalace sady Visual Studio.
virtual void OnDraw(CDC* pDC);
Parametry
[v] pDC
Poznámky
CMFCRibbonProgressBar::SetInfiniteMode
Nastaví indikátor průběhu tak, aby fungoval v nekonečném režimu.
void SetInfiniteMode(BOOL bSet = TRUE);
Parametry
bSet
[v] PRAVDA určit, že indikátor průběhu je v nekonečném režimu; jinak NEPRAVDA.
Poznámky
Obvykle platí, že pokud je indikátor průběhu v nekonečném režimu, říká uživateli, že operace probíhá, ale že čas dokončení je neznámý. Indikátor průběhu se proto opakovaně vyplní z minimální hodnoty na maximální hodnotu.
CMFCRibbonProgressBar::SetPos
Nastaví aktuální pozici indikátoru průběhu.
void SetPos(
int nPos,
BOOL bRedraw = TRUE);
Parametry
NPos
[v] Určuje pozici, na kterou je nastaven indikátor průběhu.
bRedraw
[v] Určuje, zda má být indikátor průběhu překreslen.
Poznámky
Rozsah, který se nastavuje, musí být v rozsahu určeném CMFCRibbonProgressBar::SetRange metoda.
CMFCRibbonProgressBar::SetRange
Nastaví minimální a maximální hodnoty indikátoru průběhu.
void SetRange(
int nMin,
int nMax);
Parametry
nMin
[v] Určuje minimální hodnotu rozsahu.
nMax
[v] Určuje maximální hodnotu rozsahu.
Poznámky
Tato metoda slouží k definování rozsahu indikátoru průběhu nastavením minimální a maximální hodnoty.
Viz také
Graf hierarchie
Třídy
CMFCRibbonBaseElement – třída
CMFCRibbonBar – třída