ToolBarButtonStyle Enumeration
Specifies the button style within a toolbar.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| DropDownButton | A drop-down control that displays a menu or other window when clicked. | |
| PushButton | A standard, three-dimensional button. | |
| Separator | A space or line between toolbar buttons. The appearance depends on the value of the Appearance property. | |
| ToggleButton | A toggle button that appears sunken when clicked and retains the sunken appearance until clicked again. |
This enumeration is used by members such as ToolBarButton::Style.
The toolbar button appearance is determined by the Appearance property of the toolbar. Setting the Appearance property to Flat will give the toolbar and its buttons a flat appearance. As the mouse pointer moves over the buttons, they take on a three-dimensional appearance. Also, when the toolbar has a flat appearance, button separators appear as a line rather than as a space between the buttons.
The following example instantiates a ToolBar and three ToolBarButton controls, assigns the buttons to the toolbar, and sets some of the buttons' common properties. This code assumes a MenuItem, ImageList, ToolTip and a Form have been instantiated 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