ItemDragEventArgs.Button-Eigenschaft

Ruft einen Wert ab, der angibt, welche Maustasten während des Ziehvorgangs gedrückt wurden.

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

Syntax

'Declaration
Public ReadOnly Property Button As MouseButtons
'Usage
Dim instance As ItemDragEventArgs
Dim value As MouseButtons

value = instance.Button

public MouseButtons Button { get; }

public:
property MouseButtons Button {
    MouseButtons get ();
}

/** @property */
public MouseButtons get_Button ()

public function get Button () : MouseButtons

Eigenschaftenwert

Eine bitweise Kombination von MouseButtons-Werten.

Hinweise

Mit dieser Eigenschaft können Sie bestimmen, welche Maustaste während des Drag & Drop-Vorgangs gedrückt wurde. Mit dem Wert dieser Eigenschaft können Sie genau bestimmen, wie der Drag & Drop-Vorgang durchgeführt werden soll. Möglicherweise möchten Sie z. B. ein Element an eine neue Position verschieben, wenn die linke Maustaste gedrückt wird, und an die neue Position kopieren, wenn die rechte Maustaste gedrückt wird.

Beispiel

Im folgenden Beispiel wird die Verwendung der ItemDragEventArgs-Klasse veranschaulicht, wenn Sie Drag & Drop-Vorgänge in einem TreeView-Steuerelement aktivieren. 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