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 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);
Hiérarchie d'héritage
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
nPos
[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