Questa documentazione è stata archiviata e non viene gestita.

Proprietà ToolStripItem.AllowDrop

Aggiornamento: novembre 2007

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

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public virtual bool AllowDrop { get; set; }
/** @property */
/** @attribute BrowsableAttribute(false) */
public boolean get_AllowDrop()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_AllowDrop(boolean value)

public function get AllowDrop () : boolean
public function set AllowDrop (value : boolean)

Valore proprietà

Tipo: System.Boolean

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

EccezioneCondizione
ArgumentException

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

Impostare la proprietà AllowDrop su true e la proprietà AllowItemReorder su false per ottenere il comportamento di trascinamento della selezione definito negli eventi ToolStripItem.DragEnter, ToolStripItem.DragLeave e ToolStripItem.DragDrop.

Impostare la proprietà AllowDrop su false e la proprietà AllowItemReorder su true per far sì che la classe ToolStripItem gestisca privatamente le operazioni di trascinamento e di riordinamento degli elementi.

Se entrambe le proprietà AllowDrop e AllowItemReorder vengono impostate su true verrà generata un'eccezione.

Nell'esempio di codice riportato di seguito viene illustrato come impostare la proprietà AllowDrop. Questo esempio di codice fa parte di un esempio più esaustivo fornito per la classe 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;
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0
Mostra: