ItemDragEventArgs Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Stellt Daten für das ItemDrag-Ereignis des ListView-Steuerelements und des TreeView-Steuerelements bereit.

public ref class ItemDragEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class ItemDragEventArgs : EventArgs

public class ItemDragEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ItemDragEventArgs = class
    inherit EventArgs

type ItemDragEventArgs = class
    inherit EventArgs

Public Class ItemDragEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

ItemDragEventArgs

Attribute

ComVisibleAttribute

Beispiele

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

Das vollständige Beispiel finden Sie im TreeView.ItemDrag Referenzthema.

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

Hinweise

Das ItemDrag Ereignis tritt auf, wenn der Benutzer beginnt, ein Element zu ziehen. Ein ItemDragEventArgs Objekt gibt an, welche Maustaste gedrückt wurde.

Konstruktoren

ItemDragEventArgs(MouseButtons)	Initialisiert eine neue Instanz der ItemDragEventArgs-Klasse mit einer angegebenen Maustaste.
ItemDragEventArgs(MouseButtons, Object)	Initialisiert eine neue Instanz der ItemDragEventArgs-Klasse mit einer angegebenen Maustaste sowie dem Element, das gezogen wird.

Eigenschaften

Button	Ruft einen Wert ab, der angibt, welche Maustasten während des Ziehvorgangs gedrückt wurden.
Item	Ruft das Element ab, das gezogen wird.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)