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

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

ToolBar botões são capazes de exibir ícones dentro deles para facilitar a identificação pelos usuários. Isso é obtido por meio de adicionar imagens à ImageList componente (Windows Forms) componente e, em seguida, associar a ImageList componente com o ToolBar controle.

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

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

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

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

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

   Seguindo as etapas acima, você deve ter escrito 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: disparar de eventos de menu para botões da barra de ferramentas

Referência

ToolBar

Outros recursos

controle de barra de ferramentas (Windows Forms)

ImageList componente (Windows Forms)