Partilhar via

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

  • Artigo

Observação

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

Os botões ToolBar são capazes de exibir ícones no seu interior para fácil identificação pelos utilizadores. Isso é conseguido adicionando imagens ao componente ImageList e, em seguida, associando o componente ao controle .

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

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

  2. No mesmo procedimento, atribua uma imagem ao componente ImageList.

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

    No exemplo de código a seguir, o caminho definido para o local da imagem é a pasta My Documents. Isso é feito, porque você pode assumir que a maioria dos computadores que executam o sistema operacional Windows incluirá esse diretório. Isso também permite que usuários com níveis mínimos de acesso ao sistema executem o aplicativo com segurança. O exemplo abaixo assume um formulário com um controle PictureBox já adicionado.

    Seguindo as etapas acima, você deve ter escrito código semelhante ao exibido 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;  
   }

Ver também