CMFCRibbonProgressBar, classe

Implémente un contrôle qui affiche l'avancement d'une opération de longue durée.

Syntaxe

class CMFCRibbonProgressBar : public CMFCRibbonBaseElement

Membres

Constructeurs publics

Nom	Description
CMFCRibbonProgressBar ::CMFCRibbonProgressBar	Construit et initialise un objet CMFCRibbonProgressBar.

Méthodes publiques

Nom	Description
CMFCRibbonProgressBar ::GetPos	Retourne la progression actuelle.
CMFCRibbonProgressBar ::GetRangeMax	Retourne la valeur maximale de la plage actuelle.
CMFCRibbonProgressBar ::GetRangeMin	Retourne la valeur minimale de la plage actuelle.
CMFCRibbonProgressBar ::GetRegularSize	Retourne la taille normale de l'élément de ruban. (Remplacements CMFCRibbonBaseElement ::GetRegularSize.)
CMFCRibbonProgressBar ::IsInfiniteMode	Spécifie si la barre de progression fonctionne en mode infini.
CMFCRibbonProgressBar ::OnDraw	Appelé par l'infrastructure pour dessiner l'élément de ruban. (Remplacements CMFCRibbonBaseElement ::OnDraw.)
CMFCRibbonProgressBar ::SetInfiniteMode	Définit la barre de progression pour fonctionner en mode infini.
CMFCRibbonProgressBar ::SetPos	Définit la progression actuelle.
CMFCRibbonProgressBar ::SetRange	Définit les valeurs minimales et maximales.

Notes

Un CMFCRibbonProgressBar peut fonctionner en deux modes : normal et infini. En mode normal, la barre de progression est remplie de gauche à droite et s’arrête lorsqu’elle atteint la valeur maximale. En mode infini, la barre de progression est remplie à plusieurs reprises de la valeur minimale à la valeur maximale. Vous pouvez utiliser le mode infini pour indiquer qu’une opération est en cours, mais que le temps d’achèvement est inconnu.

Exemple

L’exemple suivant montre comment utiliser différentes méthodes de la classe CMFCRibbonProgressBar . L’exemple montre comment définir la barre de progression pour fonctionner en mode infini (où l’heure d’achèvement d’une opération est inconnue), définir les valeurs minimales et maximales de la barre de progression et définir la position actuelle de la barre de progression. Cet extrait de code fait partie de l’exemple de démonstration MS Bureau 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);

Hiérarchie d'héritage

CObject

CMFCRibbonBaseElement

CMFCRibbonProgressBar

Spécifications

En-tête : afxRibbonProgressBar.h

CMFCRibbonProgressBar ::CMFCRibbonProgressBar

Construit et initialise un objet CMFCRibbonProgressBar .

CMFCRibbonProgressBar();

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

Paramètres

nID
[in] Spécifie l’ID de commande de la barre de progression du ruban.

nWidth
[in] Spécifie la largeur, en pixels, de la barre de progression du ruban.

nHeight
[in] Spécifie la hauteur, en pixels, de la barre de progression du ruban.

CMFCRibbonProgressBar ::GetPos

Retourne la position actuelle de la barre de progression.

int GetPos () const;

Valeur de retour

Valeur représentant la position actuelle de la barre de progression.

Notes

La plage définie doit se trouver dans la plage spécifiée par la méthode CMFCRibbonProgressBar ::SetRange .

CMFCRibbonProgressBar ::GetRangeMax

Retourne la valeur maximale actuelle de la barre de progression.

int GetRangeMax() const;

Valeur de retour

Valeur maximale de la plage actuelle.

Notes

CMFCRibbonProgressBar ::GetRangeMin

Retourne la valeur minimale actuelle de la barre de progression.

int GetRangeMin() const;

Valeur de retour

Valeur minimale de la plage actuelle.

CMFCRibbonProgressBar ::GetRegularSize

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

virtual CSize GetRegularSize(CDC* pDC);

Paramètres

[in] Pdc

Valeur de retour

Notes

CMFCRibbonProgressBar ::IsInfiniteMode

Spécifie si la barre de progression fonctionne en mode infini.

BOOL IsInfiniteMode() const;

Valeur de retour

TRUE si la barre de progression est en mode infini ; sinon, FALSE.

Notes

En mode infini, la barre de progression se remplit à plusieurs reprises de la valeur minimale à la valeur maximale. Vous pouvez utiliser le mode infini pour indiquer qu’une opération est en cours, mais que le temps d’achèvement est inconnu.

CMFCRibbonProgressBar ::OnDraw

Pour plus d’informations, consultez le code source situé dans le dossier VC\atlmfc\src\mfc de votre installation de Visual Studio.

virtual void OnDraw(CDC* pDC);

Paramètres

[in] Pdc

Notes

CMFCRibbonProgressBar ::SetInfiniteMode

Définit la barre de progression pour fonctionner en mode infini.

void SetInfiniteMode(BOOL bSet = TRUE);

Paramètres

bSet
[in] TRUE pour spécifier que la barre de progression est en mode infini ; sinon, FALSE.

Notes

En règle générale, si la barre de progression est en mode infini, il indique à l’utilisateur qu’une opération est en cours, mais que le temps d’achèvement est inconnu. Ainsi, la barre de progression se remplit à plusieurs reprises de la valeur minimale à la valeur maximale.

CMFCRibbonProgressBar ::SetPos

Définit la position actuelle de la barre de progression.

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

Paramètres

Osbl
[in] Spécifie la position à laquelle la barre de progression est définie.

bRedraw
[in] Spécifie si la barre de progression doit être redessinée.

Notes

La plage définie doit se trouver dans la plage spécifiée par la méthode CMFCRibbonProgressBar ::SetRange .

CMFCRibbonProgressBar ::SetRange

Définit les valeurs minimales et maximales de la barre de progression.

void SetRange(
    int nMin,
    int nMax);

Paramètres

Nmin
[in] Spécifie la valeur minimale de la plage.

Nmax
[in] Spécifie la valeur maximale de la plage.

Notes

Utilisez cette méthode pour définir la plage de la barre de progression en définissant des valeurs minimales et maximales.

Voir aussi

Graphique hiérarchique
Classes
CMFCRibbonBaseElement, classe
CMFCRibbonBar, classe