ItemDragEventArgs-Klasse
Stellt Daten für das ItemDrag-Ereignis des ListView-Steuerelements und des TreeView-Steuerelements bereit.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
<ComVisibleAttribute(True)> _
Public Class ItemDragEventArgs
Inherits EventArgs
'Usage
Dim instance As ItemDragEventArgs
[ComVisibleAttribute(true)]
public class ItemDragEventArgs : EventArgs
[ComVisibleAttribute(true)]
public ref class ItemDragEventArgs : public EventArgs
/** @attribute ComVisibleAttribute(true) */
public class ItemDragEventArgs extends EventArgs
ComVisibleAttribute(true)
public class ItemDragEventArgs extends EventArgs
Hinweise
Das ItemDrag-Ereignis tritt ein, wenn der Benutzer mit dem Ziehen eines Elements beginnt. Ein ItemDragEventArgs-Objekt gibt an, welche Maustaste gedrückt wurde.
Beispiel
Im folgenden Beispiel wird die Verwendung von ItemDragEventArgs beim Aktivieren von Drag & Drop-Vorgängen in einer TreeView 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 angibt, an 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
Vererbungshierarchie
System.Object
System.EventArgs
System.Windows.Forms.ItemDragEventArgs
Threadsicherheit
Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
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