ToolStripItem.AllowDrop Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ToolStripItem.cs

Obtient ou définit une valeur indiquant si le glisser-déplacer et la réorganisation des éléments sont gérés par le biais d’événements que vous implémentez.

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

Valeur de propriété

Boolean

true si les opérations de glisser-déplacer sont autorisées dans le contrôle ; sinon, false. La valeur par défaut est false.

Attributs

BrowsableAttribute

Exceptions

ArgumentException

AllowDrop et AllowItemReorder sont tous les deux définis sur true.

Exemples

L’exemple de code suivant montre comment définir la AllowDrop propriété. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ToolStripItem classe.

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

Remarques

Définissez la AllowDrop propriété sur et définissez la AllowItemReorder propriété true pour false répondre au comportement de glisser-déplacer que vous avez défini dans les événements et ToolStripItem.DragDrop les ToolStripItem.DragEnterToolStripItem.DragLeaveévénements.

Définissez la AllowDrop propriété false sur et définissez la AllowItemReorder propriété pour true que la ToolStripItem classe gère la réorganisation de glisser-déplacer et d’élément en privé.

Définition des AllowDrop propriétés et des AllowItemReorder propriétés pour true lever une exception.