Edit

Share via

How to: Define an Icon for a ToolBar Button Using the Designer

  • Article

Note

The ToolStrip control replaces and adds functionality to the ToolBar control; however, the ToolBar control is retained for both backward compatibility and future use, if you choose.

ToolBar buttons are able to display icons within them for easy identification by users. This is achieved through adding images to the ImageList component and associating it with the ToolBar control.

The following procedure requires a Windows Application project with a form containing a ToolBar control and an ImageList component. For information about setting up such a project, see How to: Create a Windows Forms application project and How to: Add Controls to Windows Forms.

To set an icon for a toolbar button at design time

  1. Add images to the ImageList component. For more information, see How to: Add or Remove ImageList Images with the Designer.

  2. Select the ToolBar control on your form.

  3. In the Properties window, set the ToolBar control's ImageList property to the ImageList component.

  4. Click the ToolBar control's Buttons property to select it, and click the ellipsis (The Ellipsis button (...) in the Properties window of Visual Studio.) button to open the ToolBarButton Collection Editor.

  5. Use the Add button to add buttons to the ToolBar control.

  6. In the Properties window that appears in the pane on the right side of the ToolBarButton Collection Editor, set the ImageIndex property of each toolbar button to one of the values in the list, which is drawn from the images you added to the ImageList component.

See also