ToolBar.DropDownArrows Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value indicating whether drop-down buttons on a toolbar display down arrows.
public:
property bool DropDownArrows { bool get(); void set(bool value); };
public bool DropDownArrows { get; set; }
member this.DropDownArrows : bool with get, set
Public Property DropDownArrows As Boolean
Property Value
true
if drop-down toolbar buttons display down arrows; otherwise, false
. The default is false
.
Examples
The following code example creates a ToolBar control, sets some of its common properties, and adds it to a Form. Delegates are also added to the ButtonClick and ButtonDropDown events. This example requires that a ToolBar named toolBar1
and an ImageList named imageList1
have been declared.
void AddToolBar()
{
// Add a toolbar and set some of its properties.
toolBar1 = gcnew ToolBar;
toolBar1->Appearance = System::Windows::Forms::ToolBarAppearance::Flat;
toolBar1->BorderStyle = System::Windows::Forms::BorderStyle::None;
toolBar1->Buttons->Add( this->toolBarButton1 );
toolBar1->ButtonSize = System::Drawing::Size( 24, 24 );
toolBar1->Divider = true;
toolBar1->DropDownArrows = true;
toolBar1->ImageList = this->imageList1;
toolBar1->ShowToolTips = true;
toolBar1->Size = System::Drawing::Size( 292, 25 );
toolBar1->TabIndex = 0;
toolBar1->TextAlign = System::Windows::Forms::ToolBarTextAlign::Right;
toolBar1->Wrappable = false;
// Add handlers for the ButtonClick and ButtonDropDown events.
toolBar1->ButtonDropDown += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonDropDown );
toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler( this, &MyToolBar::toolBar1_ButtonClicked );
// Add the toolbar to the form.
this->Controls->Add( toolBar1 );
}
private void AddToolBar()
{
// Add a toolbar and set some of its properties.
toolBar1 = new ToolBar();
toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
toolBar1.Buttons.Add(this.toolBarButton1);
toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
toolBar1.Divider = true;
toolBar1.DropDownArrows = true;
toolBar1.ImageList = this.imageList1;
toolBar1.ShowToolTips = true;
toolBar1.Size = new System.Drawing.Size(292, 25);
toolBar1.TabIndex = 0;
toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
toolBar1.Wrappable = false;
// Add handlers for the ButtonClick and ButtonDropDown events.
toolBar1.ButtonDropDown +=
new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
toolBar1.ButtonClick +=
new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);
// Add the toolbar to the form.
this.Controls.Add(toolBar1);
}
Private Sub AddToolBar()
' Add a toolbar and set some of its properties.
toolBar1 = New ToolBar()
toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat
toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None
toolBar1.Buttons.Add(Me.toolBarButton1)
toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
toolBar1.Divider = True
toolBar1.DropDownArrows = True
toolBar1.ImageList = Me.imageList1
toolBar1.ShowToolTips = True
toolBar1.Size = New System.Drawing.Size(292, 25)
toolBar1.TabIndex = 0
toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right
toolBar1.Wrappable = False
' Add handlers for the ButtonClick and ButtonDropDown events.
AddHandler toolBar1.ButtonDropDown, AddressOf toolBar1_ButtonDropDown
AddHandler toolBar1.ButtonClick, AddressOf toolBar1_ButtonClicked
' Add the toolbar to the form.
Me.Controls.Add(toolBar1)
End Sub
Remarks
When DropDownArrows is set to false
, no down arrows display on drop-down style toolbar buttons. When the user clicks the drop-down button on the toolbar, the menu drops down for selection. When the drop-down arrow is displayed, the user must press the down arrow to display the menu.