如何：定义工具栏按钮的图标

更新：2007 年 11 月

说明：
ToolStrip 控件替换了 ToolBar 控件并添加了功能；但是也可选择保留 ToolBar 控件以备向后兼容和将来使用。

ToolBar 按钮能自身中显示图标，以便用户识别。具体的实现方法是，向 ImageList 组件（Windows 窗体） 组件添加图像，然后将 ImageList 组件与 ToolBar 控件关联起来。

以编程方式设置工具栏按钮的图标

1. 在过程中，实例化 ImageList 组件和 ToolBar 控件。

2. 在同一过程中，向 ImageList 组件分配一个图像。

3. 在同一过程中，向 ToolBar 控件分配 ImageList 控件，然后分配各个工具栏按钮的 ImageIndex 属性。

   在下面的代码示例中，图标位置的路径设置是“My Documents”文件夹。这样做是因为可假定大多数运行 Windows 操作系统的计算机都包含此目录。这还将允许具有最低系统访问级别的用户安全地运行应用程序。下面的示例假定一个已添加了 PictureBox 控件的窗体。

   按照上述步骤，您应该已经编写出类似于下面显示的代码。

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

请参见

任务

如何：触发工具栏按钮的菜单事件

参考

ToolBar

其他资源

ToolBar 控件（Windows 窗体）

ImageList 组件（Windows 窗体）