Como: Definir um ícone para um botão da barra de ferramentas

Observação
O ToolStrip controle substitui e adiciona funcionalidade para o ToolBar controle; No entanto, o ToolBar controle é mantido para compatibilidade com versões anteriores e o uso futuro, se você escolher.

ToolBaros botões são capazes de exibir ícones dentro deles para facilitar a identificação pelos usuários. Isso é conseguido através da adição de imagens para o Componente ImageList (Windows Forms) de componente e associando a ImageList componente com o ToolBar de controle.

Para definir um ícone para um botão da barra de ferramentas programaticamente

1. Em um procedimento, instanciar um ImageList componente e um ToolBar de controle.

2. No mesmo procedimento, atribuir uma imagem para o ImageList componente.

3. Atribui o mesmo procedimento, o ImageList o controle para o ToolBar controlar e atribuir a ImageIndex propriedade dos botões da barra de ferramentas individual.

   No exemplo de código a seguir, o caminho definido para o local da imagem é o Meus documentos pasta. Isso é feito, pois você pode assumir que a maioria dos computadores que executam o sistema operacional Windows inclua este diretório. Isso também permite que os usuários com níveis de acesso do sistema mínimo com segurança, execute o aplicativo. O exemplo a seguir supõe um formulário com um PictureBox controle já adicionado.

   Seguindo as etapas acima, você deve ter escrito o código semelhante ao mostrado abaixo.

   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;
      }
   

Consulte também

Tarefas

Como: Eventos disparadores de Menu para botões da barra de ferramentas

Referência

ToolBar

Outros recursos

Barra de ferramentas controle (Windows Forms)

Componente ImageList (Windows Forms)