Comment : ajouter des boutons à un contrôle ToolBar

Mise à jour : novembre 2007

Remarque :
Le contrôle ToolStrip remplace le contrôle ToolBar et lui ajoute des fonctionnalités ; toutefois, le contrôle ToolBar est conservé pour la compatibilité descendante et l'utilisation future si tel est votre choix.

Une partie intégrante du contrôle ToolBar se compose des boutons que vous y ajoutez. Ces boutons peuvent être utilisés pour accéder facilement aux commandes de menu, mais ils peuvent également être placés dans une autre zone de l'interface utilisateur de votre application pour exposer à vos utilisateurs des commandes qui ne sont pas disponibles dans la structure de menu.

Les exemples ci-dessous supposent qu'un contrôle ToolBar a été ajouté à un Windows Form (Form1).

Pour ajouter des boutons par programme

1. Dans une procédure, créez des boutons de barre d'outils en les ajoutant à la collection ToolBar.Buttons.

2. Spécifiez les paramètres des propriétés d'un bouton individuel en passant l'index de ce bouton via la propriété Buttons.

   L'exemple suivant suppose un formulaire auquel un contrôle ToolBar a déjà été ajouté.

   Remarque :
   La collection ToolBar.Buttons étant une collection de base zéro, le code doit continuer en conséquence.

   Public Sub CreateToolBarButtons()
   ' Create buttons and set text property.
      ToolBar1.Buttons.Add("One")
      ToolBar1.Buttons.Add("Two")
      ToolBar1.Buttons.Add("Three")
      ToolBar1.Buttons.Add("Four")
   ' Set properties of StatusBar panels.
   ' Set Style property.
      ToolBar1.Buttons(0).Style = ToolBarButtonStyle.PushButton
      ToolBar1.Buttons(1).Style = ToolBarButtonStyle.Separator
      ToolBar1.Buttons(2).Style = ToolBarButtonStyle.ToggleButton
      ToolBar1.Buttons(3).Style = ToolBarButtonStyle.DropDownButton
   ' Set the ToggleButton's PartialPush property.
      ToolBar1.Buttons(2).PartialPush = True
   ' Instantiate a ContextMenu component and menu items.
   ' Set the DropDownButton's DropDownMenu property to the context menu.
      Dim cm As New ContextMenu()
      Dim miOne As New MenuItem("One")
      Dim miTwo As New MenuItem("Two")
      Dim miThree As New MenuItem("Three")
      cm.MenuItems.Add(miOne)
      cm.MenuItems.Add(miTwo)
      cm.MenuItems.Add(miThree)
      ToolBar1.Buttons(3).DropDownMenu = cm
   ' Set the PushButton's Pushed property.
      ToolBar1.Buttons(0).Pushed = True
   ' Set the ToolTipText property of one of the buttons.
      ToolBar1.Buttons(1).ToolTipText = "Button 2"
   End Sub
   

   public void CreateToolBarButtons()
   {
      // Create buttons and set text property.
      toolBar1.Buttons.Add("One");
      toolBar1.Buttons.Add("Two");
      toolBar1.Buttons.Add("Three");
      toolBar1.Buttons.Add("Four");
   
      // Set properties of StatusBar panels.
      // Set Style property.
      toolBar1.Buttons[0].Style = ToolBarButtonStyle.PushButton;
      toolBar1.Buttons[1].Style = ToolBarButtonStyle.Separator;
      toolBar1.Buttons[2].Style = ToolBarButtonStyle.ToggleButton;
      toolBar1.Buttons[3].Style = ToolBarButtonStyle.DropDownButton;
   
      // Set the ToggleButton's PartialPush property.
      toolBar1.Buttons[2].PartialPush = true;
   
      // Instantiate a ContextMenu component and menu items.
      // Set the DropDownButton's DropDownMenu property to 
      // the context menu.
      ContextMenu cm = new ContextMenu();
      MenuItem miOne = new MenuItem("One");
      MenuItem miTwo = new MenuItem("Two");
      MenuItem miThree = new MenuItem("Three");
      cm.MenuItems.Add(miOne);
      cm.MenuItems.Add(miTwo);
      cm.MenuItems.Add(miThree);
   
      toolBar1.Buttons[3].DropDownMenu = cm;
      // Set the PushButton's Pushed property.
      toolBar1.Buttons[0].Pushed = true;
      // Set the ToolTipText property of 1 of the buttons.
      toolBar1.Buttons[1].ToolTipText = "Button 2";
   }
   

   public:
      void CreateToolBarButtons()
      {
         // Create buttons and set text property.
         toolBar1->Buttons->Add( "One" );
         toolBar1->Buttons->Add( "Two" );
         toolBar1->Buttons->Add( "Three" );
         toolBar1->Buttons->Add( "Four" );
   
         // Set properties of StatusBar panels.
         // Set Style property.
         toolBar1->Buttons[0]->Style = ToolBarButtonStyle::PushButton;
         toolBar1->Buttons[1]->Style = ToolBarButtonStyle::Separator;
         toolBar1->Buttons[2]->Style = ToolBarButtonStyle::ToggleButton;
         toolBar1->Buttons[3]->Style = ToolBarButtonStyle::DropDownButton;
   
         // Set the ToggleButton's PartialPush property.
         toolBar1->Buttons[2]->PartialPush = true;
   
         // Instantiate a ContextMenu component and menu items.
         // Set the DropDownButton's DropDownMenu property to 
         // the context menu.
         System::Windows::Forms::ContextMenu^ cm = gcnew System::Windows::Forms::ContextMenu;
         MenuItem^ miOne = gcnew MenuItem( "One" );
         MenuItem^ miTwo = gcnew MenuItem( "Two" );
         MenuItem^ miThree = gcnew MenuItem( "Three" );
         cm->MenuItems->Add( miOne );
         cm->MenuItems->Add( miTwo );
         cm->MenuItems->Add( miThree );
         toolBar1->Buttons[3]->DropDownMenu = cm;
   
         // Set the PushButton's Pushed property.
         toolBar1->Buttons[0]->Pushed = true;
   
         // Set the ToolTipText property of 1 of the buttons.
         toolBar1->Buttons[1]->ToolTipText = "Button 2";
      }
   

Voir aussi

Tâches

Comment : définir une icône pour un bouton de barre d'outils

Comment : déclencher des événements de menu pour les boutons de barre d'outils

Référence

ToolBar

Vue d'ensemble du contrôle ToolBar (Windows Forms)

Autres ressources

ToolBar, contrôle (Windows Forms)