CToolBarCtrl::AddButtons

BOOL AddButtons ( int nNumButtons, LPTBBUTTON lpButtons );

Valeur de retour

Différent de zéro en cas de succès ; sinon zéro.

Paramètres

nNumButtons

Nombre de boutons à ajouter.

lpButtons

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

Remarques

Appelez cette fonction pour ajouter un ou plusieurs boutons à un contrôle de barre d'outils.

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

typeDef struct _TBBUTTO&N {
int iBitmap; / / base zéro index de l'image du bouton
int idCommand ; nbsp ; / / doit être envoyé lorsque le bouton de commande
BYTE fsState ;   / / bouton État--voir ci-dessous
BYTE fsStyle ;   / / bouton style--voir ci-dessous
DWORD dwData ;   / / définie par l'application valeur
int iString; / / index de base zéro du bouton label chaîne
} TBBUTTON

Les membres sont les suivants:

iBitmap

Index de base zéro de l'image du bouton. NULL si aucune image de ce bouton.

idCommand

Identificateur de commande associé au bouton. Cet identificateur est envoyé dans un message WM_COMMAND lorsque le bouton est sélectionné. Si le membre fsStyle a la valeur TBSTYLE_SEP , ce membre doit être nul.

fsState

Bouton drapeaux d'État. Il peut être une combinaison des valeurs énumérées ci-dessous:

• TBSTATE_CHECKED  ;  Le bouton a le style TBSTYLE_CHECKED et a été enfoncé.
  
  
• TBSTATE_E&NABLEDnbsp ;  Le bouton accepte l'entrée d'utilisateur. Un bouton qui n'a pas cet État n'accepte pas les entrées de l'utilisateur et est grisé.
  
  
• TBSTATE_HIDDE&Nnbsp ;  Le bouton n'est pas visible et ne peut pas recevoir l'entrée d'utilisateur.
  
  
• TBSTATE_I&NDETERMINATEnbsp ;  Le bouton est grisé.
  
  
• TBSTATE_PRESSED  ;  Le bouton a été enfoncé.
  
  
• TBSTATE_WRAPnbsp ;  Un saut de ligne suit le bouton. Le bouton doit avoir également l'état TBSTATE_E&NABLED.

fsStyle

Style de bouton. Il peut être une combinaison des valeurs énumérées ci-dessous:

• TBSTYLE_BUTTO&Nnbsp ;  Crée un bouton de commande standard.
  
  
• TBSTYLE_CHECKnbsp ;  Crée un bouton qui bascule entre les États pressés et 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é. & nbsp;
  
  
• TBSTYLE_CHECKGROUP  ;  Crée un bouton de contrôle qui reste enfoncé jusqu'à ce qu'un autre bouton dans le groupe.
  
  
• TBSTYLE_GROUP  ;  Crée un bouton qui reste enfoncé jusqu'à ce qu'un autre bouton dans le groupe.
  
  
• TBSTYLE_SEP  ;  Crée un séparateur, fournissant un petit écart entre les groupes de bouton. Un bouton qui a ce style ne reçoit pas d'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. NULL s'il n'y a pas de chaîne de ce bouton.

L'image ou la chaîne dont l'index que vous fournissez doit avoir été précédemment ajouté à la liste du contrôle de la barre d'outils à l'aide de AddBitmap, AddStringou AddStrings.

Aperçu CToolBarCtrl |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings