Compartir a través de

Cómo: Definir un icono para un botón ToolBar

Nota:

El ToolStrip control reemplaza y agrega funcionalidad al ToolBar control; sin embargo, el ToolBar control se conserva tanto para la compatibilidad con versiones anteriores como para el uso futuro, si lo desea.

ToolBar los botones pueden mostrar iconos dentro de ellos para facilitar la identificación de los usuarios. Esto se logra mediante la adición de imágenes al componente ImageList y, a continuación, la asociación del ImageList componente con el ToolBar control .

Para establecer un icono para un botón de barra de herramientas mediante programación

  1. En un procedimiento, instancie un componente ImageList y un control ToolBar.

  2. En el mismo procedimiento, asigne una imagen al ImageList componente.

  3. En el mismo procedimiento, asigne el control ImageList al control ToolBar y asigne la propiedad ImageIndex a los botones individuales de la barra de herramientas.

    En el ejemplo de código siguiente, la ruta de acceso establecida para la ubicación de la imagen es la carpeta Mis documentos . Esto se hace, ya que puede suponer que la mayoría de los equipos que ejecutan el sistema operativo Windows incluirán este directorio. Esto también permite a los usuarios con niveles mínimos de acceso del sistema ejecutar la aplicación de forma segura. En el ejemplo siguiente se supone que ya se ha agregado un formulario con un PictureBox control .

    Siguiendo los pasos anteriores, debe haber escrito código similar al que se muestra a continuación.

    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 también