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
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
nPos
[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