ItemDragEventArgs Classe

Définition

Fournit les données pour l'événement ItemDrag des contrôles ListView et TreeView.Provides data for the ItemDrag event of the ListView and TreeView controls.

public ref class ItemDragEventArgs : EventArgs
public class ItemDragEventArgs : EventArgs
[System.Runtime.InteropServices.ComVisible(true)]
public class ItemDragEventArgs : EventArgs
type ItemDragEventArgs = class
    inherit EventArgs
Public Class ItemDragEventArgs
Inherits EventArgs
Héritage
ItemDragEventArgs
Attributs

Exemples

L’exemple suivant illustre l’utilisation de ItemDragEventArgs lors de l’activation d’opérations de glisser-déplacer dans une TreeView.The following example illustrates the use of ItemDragEventArgs when enabling drag-and-drop operations within a TreeView. La propriété Button détermine si le nœud déplacé doit être déplacé ou copié vers sa destination.The Button property determines whether the dragged node should be moved or copied to its destination. Le nœud, représenté par la propriété Item, est ensuite transmis à la méthode DoDragDrop du contrôle TreeView avec une valeur indiquant l’effet souhaité.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.

Pour obtenir un exemple complet, consultez la rubrique de référence sur les 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

Remarques

L’événement ItemDrag se produit lorsque l’utilisateur commence à faire glisser un élément.The ItemDrag event occurs when the user begins dragging an item. Un objet ItemDragEventArgs spécifie le bouton de la souris sur lequel l’utilisateur a appuyé.An ItemDragEventArgs object specifies which mouse button was pressed.

Constructeurs

ItemDragEventArgs(MouseButtons)

Initialise une nouvelle instance de la classe ItemDragEventArgs avec un bouton spécifié de la souris.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button.

ItemDragEventArgs(MouseButtons, Object)

Initialise une nouvelle instance de la classe ItemDragEventArgs avec un bouton spécifié de la souris et l'élément objet de l'opération glisser.Initializes a new instance of the ItemDragEventArgs class with a specified mouse button and the item that is being dragged.

Propriétés

Button

Obtient une valeur indiquant les boutons de la souris sur lesquels l'utilisateur a appuyé lors de l'opération glisser.Gets a value that indicates which mouse buttons were pressed during the drag operation.

Item

Obtient l'élément que l'utilisateur fait glisser.Gets the item that is being dragged.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actif.Returns a string that represents the current object.

(Hérité de Object)

S’applique à