ToolBarButton::ImageIndex Property
.NET Framework (current version)
Gets or sets the index value of the image assigned to the button.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Exception | Condition |
|---|---|
| ArgumentException | The assigned value is less than -1. |
The following code example creates a ToolBar and three ToolBarButton controls, assigns the buttons to the toolbar, and sets some of the buttons' common properties. This code requires that a MenuItem, ImageList, ToolTip and a Form have been created and the ImageList has at least one Image assigned to it.
public: void InitializeMyToolBar() { // Create the ToolBar, ToolBarButton controls, and menus. ToolBarButton^ toolBarButton1 = gcnew ToolBarButton( "Open" ); ToolBarButton^ toolBarButton2 = gcnew ToolBarButton; ToolBarButton^ toolBarButton3 = gcnew ToolBarButton; ToolBar^ toolBar1 = gcnew ToolBar; MenuItem^ menuItem1 = gcnew MenuItem( "Print" ); array<MenuItem^>^ temp1 = {menuItem1}; System::Windows::Forms::ContextMenu^ contextMenu1 = gcnew System::Windows::Forms::ContextMenu( temp1 ); // Add the ToolBarButton controls to the ToolBar. toolBar1->Buttons->Add( toolBarButton1 ); toolBar1->Buttons->Add( toolBarButton2 ); toolBar1->Buttons->Add( toolBarButton3 ); // Assign an ImageList to the ToolBar and show ToolTips. toolBar1->ImageList = imageList1; toolBar1->ShowToolTips = true; /* Assign ImageIndex, ContextMenu, Text, ToolTip, and Style properties of the ToolBarButton controls. */ toolBarButton2->Style = ToolBarButtonStyle::Separator; toolBarButton3->Text = "Print"; toolBarButton3->Style = ToolBarButtonStyle::DropDownButton; toolBarButton3->ToolTipText = "Print"; toolBarButton3->ImageIndex = 0; toolBarButton3->DropDownMenu = contextMenu1; // Add the ToolBar to a form. Controls->Add( toolBar1 ); }
.NET Framework
Available since 1.1
Available since 1.1
Show: