CMFCRibbonSlider, classe

La CMFCRibbonSlider classe implémente un contrôle de curseur que vous pouvez ajouter à une barre de ruban ou à une barre d’état du ruban. Le contrôle Slider de ruban ressemble aux curseurs de zoom présents dans les applications Office 2007.

Syntaxe

class CMFCRibbonSlider : public CMFCRibbonBaseElement

Membres

Constructeurs publics

Nom	Description
CMFCRibbonSlider ::CMFCRibbonSlider	Construit et initialise un contrôle de curseur de ruban.

Méthodes publiques

Nom	Description
CMFCRibbonSlider ::GetPos	Retourne la position actuelle du contrôle de curseur.
CMFCRibbonSlider ::GetRangeMax	Retourne la valeur maximale du curseur.
CMFCRibbonSlider ::GetRangeMin	Retourne la valeur minimale du curseur.
CMFCRibbonSlider ::GetRegularSize	Retourne la taille normale de l'élément de ruban. (Remplacements CMFCRibbonBaseElement ::GetRegularSize.)
CMFCRibbonSlider ::GetZoomIncrement	Retourne la taille de l’incrément de zoom pour le contrôle de curseur.
CMFCRibbonSlider ::HasZoomButtons	Spécifie si le curseur a des boutons de zoom.
CMFCRibbonSlider ::OnDraw	Appelé par l'infrastructure pour dessiner l'élément de ruban. (Remplacements CMFCRibbonBaseElement ::OnDraw.)
CMFCRibbonSlider ::SetPos	Définit la position actuelle du contrôle curseur.
CMFCRibbonSlider ::SetRange	Spécifie la plage du contrôle de curseur en définissant les valeurs minimales et maximales.
CMFCRibbonSlider ::SetZoomButtons	Affiche ou masque les boutons de zoom.
CMFCRibbonSlider ::SetZoomIncrement	Définit la taille de l’incrément de zoom pour le contrôle curseur.

Notes

Vous pouvez utiliser la SetRange méthode pour configurer la plage d’incréments de zoom pour le curseur. Vous pouvez définir la position actuelle du curseur à l’aide de la SetPos méthode.

Vous pouvez afficher des boutons de zoom circulaires sur le côté gauche et droit du contrôle de curseur à l’aide de la SetZoomButtons méthode. Par défaut, le curseur est horizontal, le bouton de zoom gauche affiche un signe moins et le bouton de zoom droit affiche un signe plus.

La SetZoomIncrement méthode définit l’incrément à ajouter ou soustraire de la position actuelle lorsqu’un utilisateur clique sur les boutons de zoom.

Exemple

L’exemple suivant montre comment utiliser différentes méthodes dans la CMFCRibbonSlider classe pour définir les propriétés du curseur. L’exemple montre comment construire un CMFCRibbonSlider objet, afficher des boutons de zoom, définir la position actuelle du contrôle curseur et définir la plage de valeurs pour le contrôle curseur.

// Create a ribbon slider.
CMFCRibbonSlider *ribbonSlider = new CMFCRibbonSlider();
// Set the various properties of the slider.
ribbonSlider->SetZoomButtons(true);
ribbonSlider->SetPos(50, TRUE);
ribbonSlider->SetRange(0, 100);
// Add the ribbon slider to the Favorites panel.
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(ribbonSlider);

Hiérarchie d'héritage

CObject

CMFCRibbonBaseElement

CMFCRibbonSlider

Spécifications

En-tête : afxribbonslider.h

CMFCRibbonSlider ::CMFCRibbonSlider

Créez un curseur de ruban.

CMFCRibbonSlider(
    UINT nID,
    int nWidth=100);

Paramètres

nID
[in] ID du curseur.

[in]. Largeur du curseur nWidth en pixels.

Notes

Construit un curseur de ruban qui est nWidth pixels large dans la catégorie de panneau où le curseur est ajouté. Par défaut, le curseur est horizontal.

CMFCRibbonSlider ::GetPos

Retourne la position actuelle du contrôle de curseur.

int GetPos() const;

Valeur de retour

Position actuelle du contrôle de curseur, qui est une position par rapport au début du curseur.

CMFCRibbonSlider ::GetRangeMax

Obtient l’incrément maximal du curseur que le curseur peut voyager sur le contrôle de curseur.

int GetRangeMax() const;

Valeur de retour

Incrément maximal du curseur que le curseur peut parcourir sur le contrôle de curseur.

CMFCRibbonSlider ::GetRangeMin

Retourne l’incrément minimal que le curseur peut parcourir sur le contrôle curseur.

int GetRangeMin() const;

Valeur de retour

Incrément minimal que le curseur peut parcourir sur le contrôle de curseur.

CMFCRibbonSlider ::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

CMFCRibbonSlider ::GetZoomIncrement

Obtenez l’incrément de zoom pour le contrôle de curseur.

int GetZoomIncrement() const;

Valeur de retour

Incrément de zoom pour le contrôle de curseur.

CMFCRibbonSlider ::HasZoomButtons

Spécifie si le curseur a des boutons de zoom.

BOOL HasZoomButtons() const;

Valeur de retour

TRUE si le curseur a des boutons de zoom ; FALSE dans le cas contraire.

CMFCRibbonSlider ::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

CMFCRibbonSlider ::SetPos

Définissez la position actuelle du contrôle de curseur.

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

Paramètres

Osbl
[in] Spécifie la position à définir pour le curseur. La position est relative au début du curseur.

bRedraw
[in] Si la valeur est TRUE, le curseur est redessiné.

CMFCRibbonSlider ::SetRange

Définissez la plage de valeurs pour le contrôle curseur.

void SetRange(
    int nMin,
    int nMax);

Paramètres

Nmin
[in] Spécifie la valeur minimale du contrôle de curseur.

Nmax
[in] Spécifie la valeur maximale du contrôle curseur.

Notes

Spécifie la plage de valeurs pour le contrôle de curseur en définissant les valeurs minimales et maximales.

CMFCRibbonSlider ::SetZoomButtons

Afficher ou masquer les boutons de zoom.

void SetZoomButtons(BOOL bSet=TRUE);

Paramètres

[in]. bSet TRUE pour afficher les boutons de zoom ; FALSE pour les masquer.

CMFCRibbonSlider ::SetZoomIncrement

Définissez l’incrément de zoom pour le contrôle de curseur.

void SetZoomIncrement(int nZoomIncrement);

Paramètres

nZoomIncrement
[in] Spécifie l’incrément de zoom du contrôle de curseur.

Voir aussi

Graphique hiérarchique
Classes
CMFCRibbonBaseElement, classe