ToolBarButton::DropDownMenu Property
Gets or sets the menu to be displayed in the drop-down toolbar button.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: [TypeConverterAttribute((ReferenceConverter^::typeid))] property Menu^ DropDownMenu { Menu^ get(); void set(Menu^ value); }
Property Value
Type: System.Windows.Forms::Menu^A ContextMenu to be displayed in the drop-down toolbar button. The default is null.
| Exception | Condition |
|---|---|
| ArgumentException | The assigned object is not a ContextMenu. |
You can specify a ContextMenu to be displayed when the drop-down button is clicked. This property is not used unless the Style property value is set to ToolBarButtonStyle::DropDownButton.
Note |
|---|
Although the DropDownMenu property is defined as a Menu type, you must assign it a ContextMenu for it to display properly. If you are creating your own MenuItem derived class you must assign that object to a ContextMenu and assign the ContextMenu to the DropDownMenu property. |
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 an 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
