Partager via


CToolBar::SetButtons

Cette fonction membre définit l'ID de commande de chaque bouton de barre d'outils à la valeur spécifiée par l'élément correspondant du tableau lpIDArray.

BOOL SetButtons( 
   const UINT* lpIDArray, 
   int nIDCount  
);

Paramètres

  • lpIDArray
    Pointeur vers un tableau d'identificateurs de commande. Ce peut être NULL pour allouer les boutons vides.

  • nIDCount
    Le nombre d'éléments dans le tableau a globale pointe vers lpIDArray.

Valeur de retour

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

Notes

Si un élément du tableau a la valeur ID_SEPARATOR, un séparateur est créé dans la position correspondante dans la barre d'outils. Cette fonction définit également le style de chaque bouton à TBBS_BUTTON et le style de chaque séparateur à TBBS_SEPARATOR, et assigne un index d'image à chaque bouton. L'index d'image spécifie la position de l'image du bouton dans la bitmap.

Vous n'avez pas besoin de présenter des séparateurs dans la bitmap car cette fonction n'affecte pas les index d'image pour les séparateurs. Si votre barre d'outils contient des boutons aux positions 0, 1 et 3, et un séparateur à la position 2, les images aux positions 0, 1 et 2, dans la bitmap sont assignées aux boutons aux positions 0, 1, et 3, respectivement.

Si lpIDArray est NULL, cette fonction alloue de l'espace pour le nombre d'éléments spécifiés par nIDCount. Utilisation SetButtonInfo de définir les attributs de chaque élément.

Configuration requise

Header: afxext.h

Voir aussi

Référence

CToolBar, classe

Graphique de la hiérarchie

CToolBar::Create

CToolBar::SetButtonInfo

CToolBar::SetButtonStyle

CToolBar::LoadToolBar