CMFCRibbonCheckBox, classe
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 la commande de case à cocher et lpszText est l’étiquette de texte de la case à cocher.
Vous pouvez ajouter une case à cocher à un panneau de ruban à l’aide de CMFCRibbonPanel ::Add.
Hiérarchie d'héritage
Spécifications
En-tête : afxribboncheckbox.h
CMFCRibbonCheckBox ::CMFCRibbonCheckBox
Constructeur d’un objet de case à cocher du 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 case à cocher du 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 case à cocher.
virtual CSize GetCompactSize(CDC* pDC);
Paramètres
pDC
[in] Pointeur vers la capture de données modifiées associée à la case à cocher.
Valeur de retour
Retourne un CSize objet qui contient la taille compacte de la case à cocher.
Notes
Si elle n’est pas remplacée, retourne la taille intermédiaire de la case à cocher.
CMFCRibbonCheckBox ::GetIntermediateSize
Obtient la taille intermédiaire de la case à cocher.
virtual CSize GetIntermediateSize(CDC* pDC);
Paramètres
pDC
[in] Pointeur vers la capture de données modifiées associée à cette case à cocher.
Valeur de retour
Objet CSize contenant la taille intermédiaire de la case à cocher.
Notes
Si elle n’est pas remplacée, calcule la taille intermédiaire comme taille de case à cocher par défaut ( AFX_CHECK_BOX_DEFAULT_SIZE) plus la taille du texte, ainsi que les marges.
CMFCRibbonCheckBox ::GetRegularSize
Obtient la taille normale de la case à cocher.
virtual CSize GetRegularSize(CDC* pDC);
Paramètres
pDC
[in] Pointeur vers l’objet CDC associé à cette case à cocher.
Valeur de retour
Retourne un CSize objet qui contient la taille normale de la case à cocher.
Notes
Si elle n’est pas remplacée, retourne la taille intermédiaire de la case à cocher.
CMFCRibbonCheckBox ::IsDrawTooltipImage
Indique s’il existe une image d’info-bulle associée à la case à cocher.
virtual BOOL IsDrawTooltipImage() const;
Valeur de retour
Renvoie TRUE s’il existe une image d’info-bulle associée à la case à cocher, ou FALSE si ce n’est pas le cas.
Notes
CMFCRibbonCheckBox ::OnDraw
Appelé par l’infrastructure pour dessiner la case à cocher à 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 case à cocher.
Notes
CMFCRibbonCheckBox ::OnDrawMenuImage
Appelé par l’infrastructure pour dessiner une image de menu pour la case à cocher.
virtual BOOL OnDrawMenuImage(CDC*, CRect);
Paramètres
[in] CDC*
Pointeur vers la capture de données modifiées associée à la case à cocher.
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 case à cocher 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 case à cocher.
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 case à cocher.
bIsSelected
[in] TRUE si la case à cocher est cochée ou FALSE si ce n’est pas le cas.
bHighlighted
[in] TRUE si la case à cocher 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 case à cocher.
virtual BOOL SetACCData(
CWnd* pParent,
CAccessibilityData& data);
Paramètres
pParent
Fenêtre parente de la case à cocher.
data
Données d’accessibilité pour la case à cocher.
Valeur de retour
Retourne toujours TRUE.
Notes
Par défaut, cette méthode définit les données d’accessibilité pour la case à cocher 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.