CMFCRibbonProgressBar osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Olyan vezérlőt implementál, amely vizuálisan jelzi egy hosszú művelet előrehaladását.

Szemantika

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Tagok

Nyilvános konstruktorok

Név	Description
CMFCRibbonProgressBar::CMFCRibbonProgressBar	Objektumok létrehozása és inicializálása CMFCRibbonProgressBar .

Nyilvános metódusok

Név	Description
CMFCRibbonProgressBar::GetPos	Az aktuális állapotot adja vissza.
CMFCRibbonProgressBar::GetRangeMax	Az aktuális tartomány maximális értékét adja vissza.
CMFCRibbonProgressBar::GetRangeMin	Az aktuális tartomány minimális értékét adja vissza.
CMFCRibbonProgressBar::GetRegularSize	A menüszalag elemének normál méretét adja vissza. (Felülbírálja a CMFCRibbonBaseElement::GetRegularSize.)
CMFCRibbonProgressBar::IsInfiniteMode	Megadja, hogy a folyamatjelző sáv végtelen módban működik-e.
CMFCRibbonProgressBar::OnDraw	A keretrendszer meghívta a menüszalag elemének rajzolásához. (Felülbírálja a CMFCRibbonBaseElement::OnDraw.)
CMFCRibbonProgressBar::SetInfiniteMode	A folyamatjelző sávot végtelen módúra állítja be.
CMFCRibbonProgressBar::SetPos	Beállítja az aktuális folyamatot.
CMFCRibbonProgressBar::SetRange	Beállítja a minimális és a maximális értékeket.

Megjegyzések

Az A CMFCRibbonProgressBar két módban működik: normál és végtelen. Normál módban a folyamatjelző sáv balról jobbra van kitöltve, és leáll, amikor eléri a maximális értéket. Végtelen módban a folyamatjelző sáv ismételten megtelik a minimális értéktől a maximális értékig. Végtelen mód használatával jelezheti, hogy egy művelet folyamatban van, de a befejezési idő ismeretlen.

Example

Az alábbi példa bemutatja, hogyan használhat különböző metódusokat az CMFCRibbonProgressBar osztályban. A példa bemutatja, hogyan állíthatja be a folyamatjelző sávot végtelen módban való működésre (ahol egy művelet befejezési ideje ismeretlen), hogyan állíthatja be a folyamatjelző sáv minimális és maximális értékeit, és hogyan állíthatja be a folyamatjelző sáv aktuális pozícióját. Ez a kódrészlet az MS Office 2007 Demo minta része.

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

Öröklési hierarchia

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Requirements

Fejléc: afxRibbonProgressBar.h

CMFCRibbonProgressBar::CMFCRibbonProgressBar

CMFCRibbonProgressBar objektumot hoz létre és inicializál.

CMFCRibbonProgressBar();

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

Paraméterek

nID
[in] Megadja a menüszalag folyamatjelző sávjának parancsazonosítóját.

nWidth
[in] A menüszalag folyamatjelző sávjának szélességét adja meg képpontban.

nHeight
[in] A menüszalag folyamatjelző sávjának magasságát adja meg képpontban.

CMFCRibbonProgressBar::GetPos

A folyamatjelző sáv aktuális pozícióját adja vissza.

int GetPos () const;

Visszaadott érték

A folyamatjelző sáv aktuális pozícióját jelképező érték.

Megjegyzések

A beállított tartománynak a CMFCRibbonProgressBar::SetRange metódus által megadott tartományon belül kell lennie.

CMFCRibbonProgressBar::GetRangeMax

A folyamatjelző sáv aktuális maximális értékét adja vissza.

int GetRangeMax() const;

Visszaadott érték

Az aktuális tartomány maximális értéke.

Megjegyzések

CMFCRibbonProgressBar::GetRangeMin

A folyamatjelző sáv aktuális minimális tartományértékét adja vissza.

int GetRangeMin() const;

Visszaadott érték

Az aktuális tartomány minimális értéke.

CMFCRibbonProgressBar::GetRegularSize

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

virtual CSize GetRegularSize(CDC* pDC);

Paraméterek

[in] Pdc

Visszaadott érték

Megjegyzések

CMFCRibbonProgressBar::IsInfiniteMode

Megadja, hogy a folyamatjelző sáv végtelen módban működik-e.

BOOL IsInfiniteMode() const;

Visszaadott érték

IGAZ, ha a folyamatjelző sáv végtelen módban van; egyéb esetben HAMIS.

Megjegyzések

Végtelen módban a folyamatjelző sáv ismételten kitöltődik a minimális értéktől a maximális értékig. Végtelen mód használatával jelezheti, hogy egy művelet folyamatban van, de a befejezési idő ismeretlen.

CMFCRibbonProgressBar::OnDraw

További részletekért tekintse meg a Visual Studio-telepítés VC\atlmfc\src\mfc mappájában található forráskódot.

virtual void OnDraw(CDC* pDC);

Paraméterek

[in] Pdc

Megjegyzések

CMFCRibbonProgressBar::SetInfiniteMode

A folyamatjelző sávot végtelen módúra állítja be.

void SetInfiniteMode(BOOL bSet = TRUE);

Paraméterek

bSet
[in] IGAZ érték annak megadásához, hogy a folyamatjelző sáv végtelen módban van- e; egyéb esetben HAMIS.

Megjegyzések

Ha a folyamatjelző sáv végtelen módban van, általában azt jelzi a felhasználónak, hogy egy művelet folyamatban van, de a befejezési idő ismeretlen. Így a folyamatjelző sáv ismétlődően kitöltődik a minimális értéktől a maximális értékig.

CMFCRibbonProgressBar::SetPos

A folyamatjelző sáv aktuális pozícióját állítja be.

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

Paraméterek

nPos
[in] Azt a pozíciót adja meg, amelyre a folyamatjelző sáv be van állítva.

bRedraw
[in] Megadja, hogy a folyamatjelző sávot újra kell-e helyezni.

Megjegyzések

A beállított tartománynak a CMFCRibbonProgressBar::SetRange metódus által megadott tartományon belül kell lennie.

CMFCRibbonProgressBar::SetRange

Beállítja a folyamatjelző sáv minimális és maximális értékeit.

void SetRange(
    int nMin,
    int nMax);

Paraméterek

nMin
[in] A tartomány minimális értékét adja meg.

nMax
[in] A tartomány maximális értékét adja meg.

Megjegyzések

Ezzel a módszerrel meghatározhatja a folyamatjelző sáv tartományát a minimális és maximális értékek beállításával.

Lásd még

hierarchiadiagram
osztályok
CMFCRibbonBaseElement osztály
CMFCRibbonBar osztály