ItemDragEventArgs Classe

Definizione

Fornisce i dati per l’evento ItemDrag dei controlli ListView e TreeView.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
Ereditarietà
ItemDragEventArgs
Attributi

Esempio

Nell'esempio seguente viene illustrato l'uso di ItemDragEventArgs quando si abilitano le operazioni di trascinamento della selezione all'interno di un TreeView.The following example illustrates the use of ItemDragEventArgs when enabling drag-and-drop operations within a TreeView. La proprietà Button determina se il nodo trascinato deve essere spostato o copiato nella destinazione.The Button property determines whether the dragged node should be moved or copied to its destination. Il nodo, rappresentato dalla proprietà Item, viene quindi passato al metodo DoDragDrop del controllo TreeView insieme a un valore che indica l'effetto desiderato.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.

Per l'esempio completo, vedere l'argomento di riferimento TreeView.ItemDrag.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

Commenti

L'evento ItemDrag si verifica quando l'utente inizia a trascinare un elemento.The ItemDrag event occurs when the user begins dragging an item. Un oggetto ItemDragEventArgs specifica quale pulsante del mouse è stato premuto.An ItemDragEventArgs object specifies which mouse button was pressed.

Costruttori

ItemDragEventArgs(MouseButtons)

Inizializza una nuova istanza della classe ItemDragEventArgs con un pulsante del mouse specificato.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button.

ItemDragEventArgs(MouseButtons, Object)

Inizializza una nuova istanza della classe ItemDragEventArgs con un pulsante del mouse specificato e con l'elemento da trascinare.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button and the item that is being dragged.

Proprietà

Button

Ottiene un valore che indica quali pulsanti del mouse sono stati premuti durante l'operazione di trascinamento.Gets a value that indicates which mouse buttons were pressed during the drag operation.

Item

Ottiene l'elemento da trascinare.Gets the item that is being dragged.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a