Share via

CMFCRibbonCheckBox, classe

  • Article

La classe CMFCRibbonCheckBox implémente une case à cocher que vous pouvez ajouter à un volet du ruban, une barre d'outils Accès rapide ou un menu contextuel.

Syntaxe

class CMFCRibbonCheckBox : public CMFCRibbonButton

Membres

Constructeurs publics

Nom Description
CMFCRibbonCheckBox ::CMFCRibbonCheckBox Constructeur .

Méthodes publiques

Nom Description
CMFCRibbonCheckBox ::GetCompactSize (Remplacements CMFCRibbonButton ::GetCompactSize.)
CMFCRibbonCheckBox ::GetIntermediateSize (Remplacements CMFCRibbonButton ::GetIntermediateSize.)
CMFCRibbonCheckBox ::GetRegularSize (Remplacements CMFCRibbonButton ::GetRegularSize.)
CMFCRibbonCheckBox ::IsDrawTooltipImage (Substitue CMFCRibbonButton::IsDrawTooltipImage.)
CMFCRibbonCheckBox ::OnDraw (Remplacements CMFCRibbonButton ::OnDraw.)
CMFCRibbonCheckBox ::OnDrawMenuImage (Remplacements CMFCRibbonBaseElement ::OnDrawMenuImage.)
CMFCRibbonCheckBox ::OnDrawOnList (Substitue CMFCRibbonButton::OnDrawOnList.)
CMFCRibbonCheckBox ::SetACCData (Remplacements CMFCRibbonButton ::SetACCData.)

Notes

Pour utiliser un CMFCRibbonCheckBox dans votre application, ajoutez le constructeur suivant à votre code :

CMFCRibbonCheckBox (UINT nID, LPCTSTR lpszText)

où nID est l’ID de commande case activée zone et lpszText est l’étiquette de texte de la zone case activée.

Vous pouvez ajouter une zone de case activée à un panneau de ruban à l’aide de CMFCRibbonPanel ::Add.

Hiérarchie d'héritage

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonCheckBox

Spécifications

En-tête : afxribbon case activée box.h

CMFCRibbonCheckBox ::CMFCRibbonCheckBox

Constructeur d’un objet de boîte de case activée ruban

CMFCRibbonCheckBox(
    UINT nID,
    LPCTSTR lpszText);

Paramètres

nID
[in] Spécifie l’ID de commande.

lpszText
[in] Spécifie l’étiquette de texte.

Valeur de retour

Construit un objet de zone case activée ruban.

Exemple

L’exemple suivant montre comment construire un objet de la CMFCRibbonCheckBox classe.

strTemp.LoadString(IDS_RIBBON_STATUSBAR);
CMFCRibbonButton *pBtnStatusBar = new CMFCRibbonCheckBox(ID_VIEW_STATUS_BAR, strTemp);

CMFCRibbonCheckBox ::GetCompactSize

En cas de substitution, obtient la taille compacte de la zone case activée.

virtual CSize GetCompactSize(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers la capture de données modifiées associée à la zone case activée.

Valeur de retour

Retourne un CSize objet qui contient la taille compacte de la zone case activée.

Notes

Si elle n’est pas remplacée, retourne la taille intermédiaire de la zone case activée.

CMFCRibbonCheckBox ::GetIntermediateSize

Obtient la taille intermédiaire de la zone case activée.

virtual CSize GetIntermediateSize(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers la capture de données modifiées associée à cette zone case activée.

Valeur de retour

Objet CSize contenant la taille intermédiaire de la zone case activée.

Notes

S’il n’est pas substitué, calcule la taille intermédiaire en tant que taille de zone par défaut case activée (AFX_CHECK_BOX_DEFAULT_SIZE) plus la taille du texte, ainsi que les marges.

CMFCRibbonCheckBox ::GetRegularSize

Obtient la taille normale de la zone case activée.

virtual CSize GetRegularSize(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers l’objet CDC associé à cette zone case activée.

Valeur de retour

Retourne un CSize objet qui contient la taille normale de la zone case activée.

Notes

Si elle n’est pas remplacée, retourne la taille intermédiaire de la zone case activée.

CMFCRibbonCheckBox ::IsDrawTooltipImage

Indique s’il existe une image d’info-bulle associée à la zone case activée.

virtual BOOL IsDrawTooltipImage() const;

Valeur de retour

Renvoie TRUE s’il existe une image d’info-bulle associée à la zone case activée, ou FALSE si ce n’est pas le cas.

Notes

CMFCRibbonCheckBox ::OnDraw

Appelé par l’infrastructure pour dessiner la zone case activée à l’aide d’un contexte d’appareil spécifié.

virtual void OnDraw(CDC* pDC);

Paramètres

pDC
[in] Pointeur vers la capture de données modifiées dans laquelle dessiner la zone case activée.

Notes

CMFCRibbonCheckBox ::OnDrawMenuImage

Appelé par l’infrastructure pour dessiner une image de menu pour la zone case activée.

virtual BOOL OnDrawMenuImage(CDC*, CRect);

Paramètres

[in] CDC*
Pointeur vers la capture de données modifiées associée à la zone case activée.

CRect
[in] Objet CRect spécifiant le rectangle dans lequel dessiner l’image de menu.

Valeur de retour

Retourne TRUE si l’image a été dessinée, ou FALSE si ce n’est pas le cas.

Notes

Si elle n’est pas remplacée, retourne FALSE.

CMFCRibbonCheckBox ::OnDrawOnList

Appelé par l’infrastructure pour dessiner la zone case activée dans une zone de liste de commandes.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

Paramètres

pDC
[in] Pointeur vers le contexte de l’appareil dans lequel dessiner la zone case activée.

strText
[in] Texte d’affichage.

nTextOffset
[in] Distance, en pixels, du côté gauche de la zone de liste au texte d’affichage.

Rect
[in] Rectangle d’affichage de la zone case activée.

bIsSelected
[in] TRUE si la zone case activée est sélectionnée ou FALSE si ce n’est pas le cas.

bHighlighted
[in] TRUE si la zone case activée est mise en surbrillance ou FALSE si ce n’est pas le cas.

Notes

CMFCRibbonCheckBox ::SetACCData

Définit les données d’accessibilité pour la zone case activée.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Paramètres

pParent
Fenêtre parente de la zone case activée.

data
Données d’accessibilité pour la zone case activée.

Valeur de retour

Retourne toujours TRUE.

Notes

Par défaut, cette méthode définit les données d’accessibilité pour la zone case activée et retourne toujours TRUE. Remplacez cette méthode pour définir l’accessibilité des données et retourner une valeur qui indique la réussite ou l’échec.

Voir aussi

Graphique hiérarchique
Classes
CMFCRibbonPanel, classe