Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Note
La bibliothèque Microsoft Foundation Classes (MFC) continue d’être prise en charge. Toutefois, nous n’ajoutons plus de fonctionnalités ni ne mettons à jour la documentation.
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 | Descriptif |
|---|---|
| CMFCRibbonCheckBox ::CMFCRibbonCheckBox | Constructeur . |
Méthodes publiques
| Nom | Descriptif |
|---|---|
| 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.
données
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.