ItemDragEventArgs Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece dados para o evento ItemDrag dos controles ListView e TreeView.

public ref class ItemDragEventArgs : EventArgs

[System.Runtime.InteropServices.ComVisible(true)]
public class ItemDragEventArgs : EventArgs

public class ItemDragEventArgs : EventArgs

[<System.Runtime.InteropServices.ComVisible(true)>]
type ItemDragEventArgs = class
    inherit EventArgs

type ItemDragEventArgs = class
    inherit EventArgs

Public Class ItemDragEventArgs
Inherits EventArgs

Herança: Object

EventArgs
ItemDragEventArgs

Atributos: ComVisibleAttribute

Exemplos

O exemplo a seguir ilustra o uso de ItemDragEventArgs ao habilitar operações de arrastar e soltar em um TreeView. A Button propriedade determina se o nó arrastado deve ser movido ou copiado para seu destino. O nó, representado pela Item propriedade , é então passado para o TreeView método do DoDragDrop controle juntamente com um valor que indica o efeito desejado.

Para obter o exemplo completo, consulte o TreeView.ItemDrag tópico de referência.

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

Comentários

O ItemDrag evento ocorre quando o usuário começa a arrastar um item. Um ItemDragEventArgs objeto especifica qual botão do mouse foi pressionado.

Construtores

ItemDragEventArgs(MouseButtons)	Inicializa uma nova instância da classe ItemDragEventArgs com um botão do mouse especificado.
ItemDragEventArgs(MouseButtons, Object)	Inicializa uma nova instância da classe ItemDragEventArgs com um botão do mouse especificado e o item que está sendo arrastado.

Propriedades

Button	Obtém um valor que indica quais botões do mouse foram pressionados durante a operação de arrastar.
Item	Obtém o item que está sendo arrastado.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Compartilhar via