ToolStripItem.AllowDrop Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece un valor que indica si las operaciones de arrastrar y colocar y la reordenación de elementos se controlan mediante eventos que se implementan.

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

Valor de propiedad

Boolean

true si están permitidas las operaciones de arrastrar y colocar en el control; en caso contrario, false. De manera predeterminada, es false.

Atributos

BrowsableAttribute

Excepciones

ArgumentException

Tanto AllowDrop como AllowItemReorder se establecen en true.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer la AllowDrop propiedad . Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase ToolStripItem.

// 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

Comentarios

Establezca la AllowDrop propiedad true en y establezca la AllowItemReorder propiedad en false para responder al comportamiento de arrastrar y colocar que ha definido en los ToolStripItem.DragEntereventos , ToolStripItem.DragLeavey ToolStripItem.DragDrop .

Establezca la AllowDrop propiedad false en y establezca la AllowItemReorder propiedad en true para que la clase controle la ToolStripItem operación de arrastrar y colocar y el reordenamiento de elementos de forma privada.

Al establecer las AllowDrop propiedades y AllowItemReorder para true que se produzca una excepción.