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

Notes

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.

Les boutons ToolBar sont capables d'afficher des icônes pour faciliter l'identification par les utilisateurs. Pour cela, il faut ajouter des images au composant ImageList, composant (Windows Forms), puis associer le composant ImageList au contrôle ToolBar.

Pour définir l'icône d'un bouton de barre d'outils par programme

1. Dans une procédure, instanciez un composant ImageList et un contrôle ToolBar.

2. Dans la même procédure, assignez une image au composant ImageList.

3. Dans la même procédure, assignez le contrôle ImageList au contrôle ToolBar et assignez la propriété ImageIndex de chaque bouton de barre d'outils.

   Dans l'exemple de code suivant, le chemin d'accès défini pour l'emplacement de l'image est le dossier Mes documents. La plupart des ordinateurs exécutant le système d'exploitation Windows disposent, en effet, de ce dossier. Ceci permet également aux utilisateurs disposant de niveaux d'accès minimaux au système d'exécuter l'application en toute sécurité. L'exemple suivant suppose un formulaire auquel un contrôle PictureBox a déjà été ajouté.

   Si vous avez suivi les étapes ci-dessus, votre code doit être similaire au code suivant.

   Public Sub InitializeMyToolBar()
   ' Instantiate an ImageList component and a ToolBar control.
      Dim ToolBar1 as New ToolBar
      Dim ImageList1 as New ImageList
   ' Assign an image to the ImageList component.
   ' You should replace the bold image
   ' in the sample below with an icon of your own choosing.
      Dim myImage As System.Drawing.Image = _ 
         Image.FromFile Image.FromFile _
         (System.Environment.GetFolderPath _
         (System.Environment.SpecialFolder.Personal) _
         & "\Image.gif")
      ImageList1.Images.Add(myImage)
   ' Create a ToolBarButton.
      Dim ToolBarButton1 As New ToolBarButton()
   ' Add the ToolBarButton to the ToolBar.
      ToolBar1.Buttons.Add(toolBarButton1)
   ' Assign an ImageList to the ToolBar.
      ToolBar1.ImageList = ImageList1
   ' Assign the ImageIndex property of the ToolBarButton.
      ToolBarButton1.ImageIndex = 0
   End Sub
   

   public void InitializeMyToolBar()
   {
      // Instantiate an ImageList component and a ToolBar control.
      ToolBar toolBar1 = new  ToolBar(); 
      ImageList imageList1 = new ImageList();
      // Assign an image to the ImageList component.
      // You should replace the bold image 
      // in the sample below with an icon of your own choosing.
      // Note the escape character used (@) when specifying the path.
      Image myImage = Image.FromFile
      (System.Environment.GetFolderPath
      (System.Environment.SpecialFolder.Personal)
      + @"\Image.gif");
      imageList1.Images.Add(myImage);
      // Create a ToolBarButton.
      ToolBarButton toolBarButton1 = new ToolBarButton();
      // Add the ToolBarButton to the ToolBar.
      toolBar1.Buttons.Add(toolBarButton1);
      // Assign an ImageList to the ToolBar.
      toolBar1.ImageList = imageList1;
      // Assign ImageIndex property of the ToolBarButton.
      toolBarButton1.ImageIndex = 0;
   }
   

   public:
      void InitializeMyToolBar()
      {
         // Instantiate an ImageList component and a ToolBar control.
         ToolBar ^ toolBar1 = gcnew  ToolBar(); 
         ImageList ^ imageList1 = gcnew ImageList();
         // Assign an image to the ImageList component.
         // You should replace the bold image 
         // in the sample below with an icon of your own choosing.
         Image ^ myImage = Image::FromFile(String::Concat
            (System::Environment::GetFolderPath
            (System::Environment::SpecialFolder::Personal),
            "\\Image.gif"));
         imageList1->Images->Add(myImage);
         // Create a ToolBarButton.
         ToolBarButton ^ toolBarButton1 = gcnew ToolBarButton();
         // Add the ToolBarButton to the ToolBar.
         toolBar1->Buttons->Add(toolBarButton1);
         // Assign an ImageList to the ToolBar.
         toolBar1->ImageList = imageList1;
         // Assign ImageIndex property of the ToolBarButton.
         toolBarButton1->ImageIndex = 0;
      }
   

Voir aussi

Tâches

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

Référence

ToolBar

Autres ressources

ToolBar, contrôle (Windows Forms)

ImageList, composant (Windows Forms)