ToolBarButton::DropDownMenu Property

 

Gets or sets the menu to be displayed in the drop-down toolbar button.

Namespace:   System.Windows.Forms
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.

System_CAPS_noteNote

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 );
   }

.NET Framework
Available since 1.1
Return to top
Show: