Classe de CButton

Article
03/26/2013

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.