ItemDragEventArgs.Item Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

ItemDragEventArgs.cs

Obtém o item que está sendo arrastado.

public:
 property System::Object ^ Item { System::Object ^ get(); };

public object? Item { get; }

member this.Item : obj

Public ReadOnly Property Item As Object

Valor da propriedade

Object

Um objeto que representa o item que está sendo arrastado.

Exemplos

O exemplo a seguir ilustra o uso de ItemDragEventArgs ao habilitar operações de arrastar e soltar dentro de um TreeView controle. 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 da operação de arrastar e soltar.

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

Você pode usar essa propriedade para determinar qual item dos TreeView controles ou ListView está sendo arrastado do controle.