ToolStripItem.AllowDrop プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
実装するイベントによって、ドラッグ アンド ドロップおよび項目の順番変更が処理されるかどうかを示す値を取得または設定します。
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, setPublic Overridable Property AllowDrop As Booleanプロパティ値
コントロールでドラッグ アンド ドロップ操作を実行できる場合は true。それ以外の場合は false。 既定値は、false です。
- 属性
例外
AllowDrop および AllowItemReorder がどちらも true に設定されています。
例
次のコード例では、 プロパティを設定する方法を AllowDrop 示します。 このコード例は、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
注釈
プロパティを AllowDrop にtrue設定し、 プロパティを AllowItemReorder にfalse設定して、および ToolStripItem.DragDrop イベントで定義したドラッグ アンド ドロップ動作にToolStripItem.DragEnterToolStripItem.DragLeave応答します。
プロパティを AllowDrop に false 設定し、 プロパティを AllowItemReorder に true 設定して、クラスが ToolStripItem ドラッグ アンド ドロップとアイテムの並べ替えをプライベートに処理するようにします。
プロパティと プロパティの両方 AllowDrop を AllowItemReorder に true 設定すると、例外がスローされます。
適用対象
.NET