ToolBarButton::Style Property
Gets or sets the style of the toolbar button.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: property ToolBarButtonStyle Style { ToolBarButtonStyle get(); void set(ToolBarButtonStyle value); }
Property Value
Type: System.Windows.Forms::ToolBarButtonStyleOne of the ToolBarButtonStyle values. The default is ToolBarButtonStyle.PushButton.
| Exception | Condition |
|---|---|
| InvalidEnumArgumentException | The assigned value is not one of the ToolBarButtonStyle values. |
If the button Style is set to DropDownButton you can specify a MenuItem to be displayed when the drop-down button is pressed. If the style is set to ToolBarButtonStyle.Separator, the toolbar button appears as a button separator and not as a button. The ToolBarButtonStyle.ToggleButton style causes the toolbar button to act like a toggle button; it can be in an on or off state.
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 ); }
Available since 1.1