Partilhar via


ItemDragEventArgs.Button Propriedade

Definição

Obtém um valor que indica quais botões do mouse foram pressionados durante a operação de arrastar.

public:
 property System::Windows::Forms::MouseButtons Button { System::Windows::Forms::MouseButtons get(); };
public System.Windows.Forms.MouseButtons Button { get; }
member this.Button : System.Windows.Forms.MouseButtons
Public ReadOnly Property Button As MouseButtons

Valor da propriedade

Uma combinação bit a bit dos valores MouseButtons.

Exemplos

O exemplo a seguir ilustra o uso da ItemDragEventArgs classe quando você habilita 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

Essa propriedade permite determinar quais botões do mouse foram pressionados durante uma operação de arrastar e soltar. O valor dessa propriedade pode ser usado para determinar corretamente como a operação de arrastar e soltar deve ser executada. Por exemplo, talvez você queira mover um item para um novo local quando o botão esquerdo do mouse for pressionado e copiá-lo para o novo local quando o botão direito do mouse for pressionado.

Aplica-se a