CToolBarCtrl::AddButtons

Article
03/04/2013

Ajoute un ou plusieurs boutons à un contrôle de barre d'outils.

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

Paramètres

nNumButtons
Nombre de boutons à ajouter.
lpButtons
Adresse d'un tableau de structures d' TBBUTTON qui contient des informations sur les boutons pour ajouter.Il doit y avoir le même nombre d'éléments dans le tableau comme boutons spécifiés par nNumButtons.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon zéro.

Notes

Les points du pointeur d' lpButtons à un tableau de structures d' TBBUTTON .Chaque structure d' TBBUTTON associe le bouton ajouté avec le style du bouton, l'image et/ou la chaîne, l'ID de commande, l'état, et les données définies par l'utilisateur :

typedef struct _TBBUTTON {

int iBitmap;// zero-based index of button image

int idCommand; // command to be sent when button pressed

BYTE fsState; // button state--see below

BYTE fsStyle; // button style--see below

DWORD dwData; // application-defined value

int iString;// zero-based index of button label string

} TBBUTTON;

Les membres sont les suivantes :

iBitmap
Index de base zéro de l'image de bouton, -1 si aucune image pour ce bouton.
idCommand
ID de commande associé à le bouton.Cet identificateur est introduit un message de WM_COMMAND lorsque le bouton est sélectionnez.Si le membre de fsStyle a la valeur d' TBSTYLE_SEP , ce membre doit être égal à zéro.
fsState
Balises d'état du bouton.Il peut être une combinaison de valeurs répertoriées ci-dessous :
- TBSTATE_CHECKED le bouton a le style de TBSTYLE_CHECKED et est enfoncé.
- TBSTATE_ENABLED le bouton accepte l'entrée d'utilisateur.Un bouton qui n'a pas ce rapport n'accepte pas les entrées d'utilisateur et est grisé.
- TBSTATE_HIDDEN le bouton n'est pas visible et ne peut pas recevoir l'entrée d'utilisateur.
- TBSTATE_INDETERMINATE le bouton est grisé.
- TBSTATE_PRESSED le bouton est enfoncé.
- Le saut de ligne d'TBSTATE_WRAP A suit le bouton.Le bouton doit également avoir l'état d' TBSTATE_ENABLED .
fsStyle
Style de boutons.Il peut être une combinaison de valeurs répertoriées ci-dessous :
- TBSTYLE_BUTTON crée un bouton de commande standard.
- TBSTYLE_CHECK crée un bouton qui alterne enfoncé et les rapports non enfoncés chaque fois que l'utilisateur clique dessus.Le bouton a une couleur d'arrière-plan différente lorsqu'il est dans l'état enfoncé.
- TBSTYLE_CHECKGROUP crée un bouton de contrôle qui reste enfoncé jusqu'à ce qu'un autre bouton dans le groupe est enfoncé.
- TBSTYLE_GROUP crée un bouton qui reste enfoncé jusqu'à ce qu'un autre bouton dans le groupe est enfoncé.
- TBSTYLE_SEP crée un séparateur, en fournissant un petit intervalle entre les groupes de boutons.Un bouton possédant ce style ne reçoit pas l'entrée d'utilisateur.
dwData
Données définies par l'utilisateur.
iString
Index de base zéro de la chaîne à utiliser comme étiquette du bouton, -1 en l'absence de chaîne pour ce bouton.

L'image et/ou la chaîne dont l'index que vous fournissez doit avoir été déjà ajouté à la liste de contrôles de barre d'outils à AddBitmap, AddString, et/ou AddStrings.