ItemDragEventArgs.Item-Eigenschaft

Ruft das Element ab, das gezogen wird.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public ReadOnly Property Item As Object
'Usage
Dim instance As ItemDragEventArgs
Dim value As Object

value = instance.Item

public Object Item { get; }

public:
property Object^ Item {
    Object^ get ();
}

/** @property */
public Object get_Item ()

public function get Item () : Object

Eigenschaftenwert

Ein Objekt, das das derzeit gezogene Element darstellt.

Hinweise

Mit dieser Eigenschaft können Sie bestimmen, welches Element aus dem TreeView-Steuerelement oder dem ListView-Steuerelement aus dem Steuerelement gezogen wird.

Beispiel

Im folgenden Beispiel wird die Verwendung von ItemDragEventArgs beim Aktivieren von Drag & Drop-Vorgängen in einem TreeView-Steuerelement veranschaulicht. Die Button-Eigenschaft bestimmt, ob der gezogene Knoten in das Ziel verschoben oder kopiert werden soll. Der durch die Item-Eigenschaft dargestellte Knoten wird dann zusammen mit dem Wert, der den gewünschten Effekt des Drag & Drop-Vorgangs angibt, and die DoDragDrop-Methode des TreeView-Steuerelements übergeben.

Das vollständige Beispiel finden Sie unter dem Referenzthema zu 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

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

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

private void treeView1_ItemDrag(Object sender, ItemDragEventArgs e)
{
    // Move the dragged node when the left mouse button is used.
    if (e.get_Button().Equals(get_MouseButtons().Left)) {
        DoDragDrop(e.get_Item(), DragDropEffects.Move);
    }
    // Copy the dragged node when the right mouse button is used.
    else {
        if (e.get_Button().Equals(get_MouseButtons().Right)) {
            DoDragDrop(e.get_Item(), DragDropEffects.Copy);
        }
    }
} //treeView1_ItemDrag

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ItemDragEventArgs-Klasse
ItemDragEventArgs-Member
System.Windows.Forms-Namespace