ItemDragEventArgs Klasse

Definition

Stellt Daten für das ItemDrag-Ereignis des ListView-Steuerelements und des TreeView-Steuerelements bereit.Provides data for the ItemDrag event of the ListView and TreeView controls.

public ref class ItemDragEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class ItemDragEventArgs : EventArgs
type ItemDragEventArgs = class
    inherit EventArgs
Public Class ItemDragEventArgs
Inherits EventArgs
Vererbung
ItemDragEventArgs
Attribute

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung von ItemDragEventArgs beim Aktivieren von Drag & Drop-Vorgängen innerhalb TreeVieweines.The following example illustrates the use of ItemDragEventArgs when enabling drag-and-drop operations within a TreeView. Die Button -Eigenschaft bestimmt, ob der gezogene Knoten verschoben oder in das Ziel kopiert werden soll.The Button property determines whether the dragged node should be moved or copied to its destination. Der durch die Item -Eigenschaft dargestellte-Knoten wird dann an die-Methode DoDragDrop des TreeView -Steuer Elements weitergegeben, zusammen mit einem Wert, der den gewünschten Effekt angibt.The node, represented by the Item property, is then passed to the TreeView control's DoDragDrop method along with a value indicating the desired effect.

Das komplette Beispiel finden Sie im TreeView.ItemDrag Referenz Thema.For the complete example, see the TreeView.ItemDrag reference topic.

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 mit dem Ziehen eines Elements beginnt.The ItemDrag event occurs when the user begins dragging an item. Ein ItemDragEventArgs -Objekt gibt an, welche Maustaste gedrückt wurde.An ItemDragEventArgs object specifies which mouse button was pressed.

Konstruktoren

ItemDragEventArgs(MouseButtons)

Initialisiert eine neue Instanz der ItemDragEventArgs-Klasse mit einer angegebenen Maustaste.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button.

ItemDragEventArgs(MouseButtons, Object)

Initialisiert eine neue Instanz der ItemDragEventArgs-Klasse mit einer angegebenen Maustaste sowie dem Element, das gezogen wird.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button and the item that is being dragged.

Eigenschaften

Button

Ruft einen Wert ab, der angibt, welche Maustasten während des Ziehvorgangs gedrückt wurden.Gets a value that indicates which mouse buttons were pressed during the drag operation.

Item

Ruft das Element ab, das gezogen wird.Gets the item that is being dragged.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für: