ItemDragEventArgs.Item Propriedade

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

public object Item { get; }

public object? Item { get; }

member this.Item : obj

Public ReadOnly Property Item As Object

Valor de Propriedade

Um objeto que representa o item que está a ser arrastado.

Exemplos

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

Para 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

Observações

Podes usar esta propriedade para determinar qual item dos TreeView controlos ou ListView está a ser arrastado para fora do controlo.