ToolStrip.AllowDrop Property

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ToolStrip.cs

Gets or sets a value indicating whether drag-and-drop and item reordering are handled through events that you implement.

C#

public override bool AllowDrop { get; set; }

Property Value

Boolean

true to control drag-and-drop and item reordering through events that you implement; otherwise, false.

Exceptions

ArgumentException

AllowDrop and AllowItemReorder are both set to true.

Examples

The following code example demonstrates the syntax for setting common ToolStrip properties, including the AllowDrop property.

C#

// This is an example of some common ToolStrip property settings.
// 
toolStrip1.AllowDrop = false;
toolStrip1.AllowItemReorder = true;
toolStrip1.AllowMerge = false;
toolStrip1.Anchor = ((System.Windows.Forms.AnchorStyles)(((System.Windows.Forms.AnchorStyles.Top | System.Windows.Forms.AnchorStyles.Left)
            | System.Windows.Forms.AnchorStyles.Right)));
toolStrip1.AutoSize = false;
toolStrip1.CanOverflow = false;
toolStrip1.Cursor = System.Windows.Forms.Cursors.Cross;
toolStrip1.DefaultDropDownDirection = System.Windows.Forms.ToolStripDropDownDirection.BelowRight;
toolStrip1.Dock = System.Windows.Forms.DockStyle.None;
toolStrip1.GripMargin = new System.Windows.Forms.Padding(3);
toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
toolStripButton1});
toolStrip1.ImageScalingSize = new System.Drawing.Size(20, 20);
toolStrip1.LayoutStyle = System.Windows.Forms.ToolStripLayoutStyle.HorizontalStackWithOverflow;
toolStrip1.Location = new System.Drawing.Point(0, 0);
toolStrip1.Margin = new System.Windows.Forms.Padding(1);
toolStrip1.Name = "toolStrip1";
toolStrip1.Padding = new System.Windows.Forms.Padding(0, 0, 2, 0);
toolStrip1.RenderMode = System.Windows.Forms.ToolStripRenderMode.System;
toolStrip1.ShowItemToolTips = false;
toolStrip1.Size = new System.Drawing.Size(109, 273);
toolStrip1.Stretch = true;
toolStrip1.TabIndex = 0;
toolStrip1.TabStop = true;
toolStrip1.Text = "toolStrip1";
toolStrip1.TextDirection = System.Windows.Forms.ToolStripTextDirection.Vertical90;

Remarks

Set the AllowDrop property to true and set the AllowItemReorder property to false to respond to drag-and-drop behavior you have defined in the Control.DragEnter, Control.DragLeave, and Control.DragDrop events.

Set AllowDrop to false and set AllowItemReorder to true to cause the ToolStrip class to handle drag-and-drop and item reordering automatically. Set AllowItemReorder to true for two ToolStrip objects to allow dragging of items from one ToolStrip to the other. To enable the default drag-and-drop, the ALT key must be pressed during the drag operation.

Setting both AllowDrop and AllowItemReorder to true throws an exception.

Applies to

See also

• AllowItemReorder
• DragEnter
• DragLeave
• DragDrop