ItemDragEventArgs クラス

ListView コントロールと TreeView コントロールの ItemDrag イベントのデータを提供します。

この型のすべてのメンバの一覧については、ItemDragEventArgs メンバ を参照してください。

System.Object
   System.EventArgs
      System.Windows.Forms.ItemDragEventArgs

<ComVisible(True)>
Public Class ItemDragEventArgs   Inherits EventArgs
[C#]
[ComVisible(true)]
public class ItemDragEventArgs : EventArgs
[C++]
[ComVisible(true)]
public __gc class ItemDragEventArgs : public EventArgs
[JScript]
public
   ComVisible(true)
class ItemDragEventArgs extends EventArgs

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

ItemDrag イベントは、ユーザーが項目のドラッグを開始すると発生します。 ItemDragEventArgs オブジェクトは、どちらのマウス ボタンが押されたかを示します。

使用例

[Visual Basic, C#, C++] TreeView 内のドラッグ アンド ドロップ操作が有効な場合の ItemDragEventArgs の使用例を次に示します。ドラッグしたノードがドラッグ先に移動されるかコピーされるかは、 Button プロパティによって決まります。次に、 Item プロパティによって表されているノードが、期待した効果を示す値と共に System.Windows.Forms.TreeView.DoDragDrop メソッドに渡されます。

[Visual Basic, C#, C++] 詳細については、 TreeView.ItemDrag のリファレンス トピックを参照してください。

 
Private Sub treeView1_ItemDrag(ByVal sender As Object, ByVal e As ItemDragEventArgs)

    ' Move the dragged node when the left mouse button is used.
    If e.Button = MouseButtons.Left Then
        DoDragDrop(e.Item, DragDropEffects.Move)

    ' Copy the dragged node when the right mouse button is used.
    ElseIf e.Button = MouseButtons.Right Then
        DoDragDrop(e.Item, DragDropEffects.Copy)
    End If
End Sub 'treeView1_ItemDrag

[C#] 
private void treeView1_ItemDrag(object sender, ItemDragEventArgs e)
{
    // Move the dragged node when the left mouse button is used.
    if (e.Button == MouseButtons.Left)
    {
        DoDragDrop(e.Item, DragDropEffects.Move);
    }

    // Copy the dragged node when the right mouse button is used.
    else if (e.Button == MouseButtons.Right)
    {
        DoDragDrop(e.Item, DragDropEffects.Copy);
    }
}

[C++] 
private:
    void treeView1_ItemDrag(Object* /*sender*/, ItemDragEventArgs* e)
    {
        // Move the dragged node when the left mouse button is used.
        if (e->Button == MouseButtons::Left)
        {
            DoDragDrop(e->Item, DragDropEffects::Move);
        }

        // Copy the dragged node when the right mouse button is used.
        else if (e->Button == MouseButtons::Right)
        {
            DoDragDrop(e->Item, DragDropEffects::Copy);
        }
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

ItemDragEventArgs メンバ | System.Windows.Forms 名前空間