ToolStripItem.AllowDrop Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob Drag & Drop und die Neuordnung von Elementen über von Ihnen implementierte Ereignisse behandelt werden, oder legt diesen Wert fest.

public:
 virtual property bool AllowDrop { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(false)]
public virtual bool AllowDrop { get; set; }

[<System.ComponentModel.Browsable(false)>]
member this.AllowDrop : bool with get, set

Public Overridable Property AllowDrop As Boolean

Eigenschaftswert

Boolean

true, wenn Drag & Drop-Vorgänge für das Steuerelement zulässig sind, andernfalls false. Der Standardwert ist false.

Attribute

BrowsableAttribute

Ausnahmen

ArgumentException

AllowDrop und AllowItemReorder sind auf true festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die -Eigenschaft festgelegt wird AllowDrop . Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die ToolStripItem-Klasse bereitgestellt wird.

// This utility method creates a RolloverItem 
// and adds it to a ToolStrip control.
private RolloverItem CreateRolloverItem(
    ToolStrip owningToolStrip,
    string txt,
    Font f,
    string imgKey,
    TextImageRelation tir,
    string backImgKey)
{
    RolloverItem item = new RolloverItem();

    item.Alignment = ToolStripItemAlignment.Left;
    item.AllowDrop = false;
    item.AutoSize = true;

    item.BackgroundImage = owningToolStrip.ImageList.Images[backImgKey];
    item.BackgroundImageLayout = ImageLayout.Center;
    item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText;
    item.DoubleClickEnabled = true;
    item.Enabled = true;
    item.Font = f;

    // These assignments are equivalent. Each assigns an
    // image from the owning toolstrip's image list.
    item.ImageKey = imgKey;
    //item.Image = owningToolStrip.ImageList.Images[infoIconKey];
    //item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
    item.ImageScaling = ToolStripItemImageScaling.None;

    item.Owner = owningToolStrip;
    item.Padding = new Padding(2);
    item.Text = txt;
    item.TextAlign = ContentAlignment.MiddleLeft;
    item.TextDirection = ToolStripTextDirection.Horizontal;
    item.TextImageRelation = tir;

    return item;
}

' This utility method creates a RolloverItem 
' and adds it to a ToolStrip control.
 Private Function CreateRolloverItem( _
 ByVal owningToolStrip As ToolStrip, _
 ByVal txt As String, _
 ByVal f As Font, _
 ByVal imgKey As String, _
 ByVal tir As TextImageRelation, _
 ByVal backImgKey As String) As RolloverItem

     Dim item As New RolloverItem()

     item.Alignment = ToolStripItemAlignment.Left
     item.AllowDrop = False
     item.AutoSize = True

     item.BackgroundImage = owningToolStrip.ImageList.Images(backImgKey)
     item.BackgroundImageLayout = ImageLayout.Center
     item.DisplayStyle = ToolStripItemDisplayStyle.ImageAndText
     item.DoubleClickEnabled = True
     item.Enabled = True
     item.Font = f

     ' These assignments are equivalent. Each assigns an
     ' image from the owning toolstrip's image list.
     item.ImageKey = imgKey
     'item.Image = owningToolStrip.ImageList.Images[infoIconKey];
     'item.ImageIndex = owningToolStrip.ImageList.Images.IndexOfKey(infoIconKey);
     item.ImageScaling = ToolStripItemImageScaling.None

     item.Owner = owningToolStrip
     item.Padding = New Padding(2)
     item.Text = txt
     item.TextAlign = ContentAlignment.MiddleLeft
     item.TextDirection = ToolStripTextDirection.Horizontal
     item.TextImageRelation = tir

     Return item
 End Function

Hinweise

Legen Sie die AllowDrop -Eigenschaft auf fest true , und legen Sie die AllowItemReorder -Eigenschaft auf fest false , um auf das Drag-and-Drop-Verhalten zu reagieren, das Sie in den ToolStripItem.DragEnterEreignissen , ToolStripItem.DragLeaveund ToolStripItem.DragDrop definiert haben.

Legen Sie die AllowDrop -Eigenschaft auf false fest, und legen Sie die AllowItemReorder -Eigenschaft auf fest true , damit die ToolStripItem Klasse das Ziehen und Ablegen und die Neuanordnung von Elementen privat verarbeitet.

Wenn Sie sowohl die AllowDrop -Eigenschaft als auch die AllowItemReorder -Eigenschaft auf festlegen, true wird eine Ausnahme ausgelöst.