ToolStripItem.AllowDrop Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ToolStripItem.cs

Ottiene o imposta un valore che indica se le operazioni di trascinamento della selezione e ridisposizione degli elementi devono essere gestite tramite eventi implementati dallo sviluppatore.

C#

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

Valore della proprietà

Boolean

true se le operazioni di trascinamento della selezione sono consentite nel controllo; in caso contrario, false. Il valore predefinito è false.

Attributi

BrowsableAttribute

Eccezioni

ArgumentException

Le proprietà AllowDrop e AllowItemReorder sono entrambe impostate su true.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la AllowDrop proprietà . Questo esempio di codice fa parte di un esempio più ampio fornito per la ToolStripItem classe .

C#

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

Commenti

Impostare la AllowDrop proprietà su true e impostare la AllowItemReorder proprietà su per false rispondere al comportamento di trascinamento della selezione definito negli ToolStripItem.DragEntereventi , ToolStripItem.DragLeavee ToolStripItem.DragDrop .

Impostare la AllowDrop proprietà su false e impostare la AllowItemReorder proprietà su true per fare in modo che la ToolStripItem classe gestisca il trascinamento della selezione e l'ordinamento degli elementi in modo privato.

Impostando sia le AllowDrop proprietà che le AllowItemReorder proprietà per true generare un'eccezione.

Si applica a