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

Jméno	popis
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Vytvoří a inicializuje CMFCRibbonProgressBar objekt.

Veřejné metody

Jméno	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

Objekt CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

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;

Vrácená 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;

Vrácená 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;

Vrácená 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

Vrácená hodnota

Poznámky

CMFCRibbonProgressBar::IsInfiniteMode

Určuje, jestli indikátor průběhu pracuje v nekonečném režimu.

BOOL IsInfiniteMode() const;

Vrácená 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