Partager via


CButton, classe

Fournit les fonctionnalités des contrôles bouton windows.

class CButton : public CWnd

Membres

Constructeurs publics

Nom

Description

CButton::CButton

Construit un objet CButton.

Méthodes publiques

Nom

Description

CButton::Create

Crée le contrôle bouton windows et l'attache à l'objet d' CButton .

CButton::DrawItem

Substitution pour dessiner un objet owner-drawn d' CButton .

CButton::GetBitmap

Récupère le handle de la bitmap précédemment définie avec SetBitmap.

CButton::GetButtonStyle

Récupère des informations sur le style de contrôle button.

CButton::GetCheck

Récupère l'état d'activation d'un contrôle bouton.

CButton::GetCursor

Récupère le handle de l'image de curseur précédemment définie avec SetCursor.

CButton::GetIcon

Récupère le handle de l'icône précédemment définie avec SetIcon.

CButton::GetIdealSize

Extrait la taille idéale du contrôle bouton.

CButton::GetImageList

Récupère la liste d'images du contrôle bouton.

CButton::GetNote

Récupère le composant de remarque du contrôle de lien en cours de commande.

CButton::GetNoteLength

Extrait la longueur du texte de remarque pour le contrôle de lien en cours de commande.

CButton::GetSplitGlyph

Récupère le glyphe associé au contrôle actuel de bouton partagé.

CButton::GetSplitImageList

Récupère la liste d'images du contrôle actuel de bouton partagé.

CButton::GetSplitInfo

Récupère les informations qui définissent le contrôle actuel de bouton partagé.

CButton::GetSplitSize

Récupère le rectangle englobant du composant déroulant du contrôle actuel de bouton partagé.

CButton::GetSplitStyle

Récupère les styles de bouton partagé qui définissent le contrôle actuel de bouton partagé.

CButton::GetState

Récupère l'état d'activation, l'état de surbrillance, et l'état de focus d'un contrôle bouton.

CButton::GetTextMargin

Extrait la plage de texte du contrôle bouton.

CButton::SetBitmap

Spécifie une bitmap à afficher sur le bouton.

CButton::SetButtonStyle

Modifie le style d'un bouton.

CButton::SetCheck

Définit l'état d'activation d'un contrôle bouton.

CButton::SetCursor

Spécifie une image de curseur à afficher sur le bouton.

CButton::SetDropDownState

Définit l'état déroulant du contrôle actuel de bouton partagé.

CButton::SetIcon

Spécifie une icône à afficher sur le bouton.

CButton::SetImageList

Définit la liste d'images du contrôle bouton.

CButton::SetNote

Définit la remarque sur le contrôle de lien en cours de commande.

CButton::SetSplitGlyph

Associe un glyphe spécifié avec le contrôle actuel de bouton partagé.

CButton::SetSplitImageList

Associe une liste d'images avec le contrôle actuel de bouton partagé.

CButton::SetSplitInfo

Spécifie les informations qui définissent le contrôle actuel de bouton partagé.

CButton::SetSplitSize

Définit le rectangle englobant du composant déroulant du contrôle actuel de bouton partagé.

CButton::SetSplitStyle

Définit le style du contrôle actuel de bouton partagé.

CButton::SetState

Définit l'état de mise en surbrillance d'un contrôle bouton.

CButton::SetTextMargin

Définit la plage de texte du contrôle bouton.

Notes

Un contrôle bouton est une petite, rectangulaire fenêtre enfant qui peut être un clic de démarrer et d'arrêt. Les boutons peuvent être utilisés unique ou aux groupes et peuvent être étiquetés ou apparus sans texte. Un bouton change en général l'apparence lorsque l'utilisateur clique dessus.

Les boutons classiques sont la case à cocher, la case d'option, puis le bouton poussoir. Un objet d' CButton peut devenir l'un de ces, selon style de boutons spécifié à son initialisation par la fonction membre de Create .

En outre, la classe de CBitmapButton dérivée d' CButton charge la création de contrôles bouton étiquetés avec des images bitmap au lieu du texte. CBitmapButton peut avoir des bitmaps distinctes pour un bouton, vers le bas, le focus, et les rapports désactivés.

Vous pouvez créer un contrôle bouton d'un modèle de boîte de dialogue ou directement dans votre code. Dans les deux cas, abord appeler le constructeur CButton pour construire l'objet d' CButton ; appelez la fonction membre de Créer pour créer le contrôle bouton windows et le lier à l'objet d' CButton .

La construction peut être un processus à une étape dans une classe dérivée d' CButton. Entrez un constructeur pour la classe dérivée et appelez Créer du constructeur.

Si vous souhaitez gérer des messages de notification de fenêtres envoyés par un contrôle bouton à son parent (généralement une classe dérivée de CDialog), ajoutez une entrée de la table des messages et une fonction membre gestionnaire de messages à la classe parente pour chaque message.

Chaque entrée de la table des messages prend la forme suivante :

Notification**(id, memberFxn)**d'ON_

où id spécifie l'ID de fenêtre enfant de l'émission de contrôle la notification et memberFxn est le nom de la fonction membre parente que vous avez écrit pour traiter la notification.

Le prototype de fonction du parent est la suivante :

afx_msgvoidmemberFxn**( );**

Les entrées de la table des messages potentielles sont les suivantes :

Entrée de mappage

Envoyé au parent lorsque…

ON_BN_CLICKED

l'utilisateur clique sur un bouton.

ON_BN_DOUBLECLICKED

L'utilisateur double-clique sur un bouton.

Si vous créez un objet d' CButton d'une ressource de boîte de dialogue, l'objet d' CButton est automatiquement détruit lorsque l'utilisateur ferme la boîte de dialogue.

Si vous créez un objet d' CButton dans une fenêtre, vous devrez peut-être la destruction. Si vous créez l'objet d' CButton sur le tas à l'aide de la fonction de nouveau , vous devez appeler supprimer sur l'objet pour le détruire lorsque l'utilisateur ferme le contrôle bouton windows. Si vous créez l'objet d' CButton sur la pile, ou elle est incorporée dans l'objet dialog parent, elle est perdue automatiquement.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CButton

Configuration requise

En-tête : afxwin.h

Voir aussi

Référence

CWnd, classe

Graphique de la hiérarchie

CWnd, classe

CComboBox, classe

CEdit, classe

CListBox, classe

CScrollBar, classe

CStatic, classe

CBitmapButton, classe

CDialog, classe