Control.DragLeave Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

Control.cs

Ocorre quando um objeto é arrastado para fora dos limites do controle.

public:
 event EventHandler ^ DragLeave;

public event EventHandler? DragLeave;

member this.DragLeave : EventHandler 

Public Custom Event DragLeave As EventHandler 

Tipo de evento

EventHandler

Exemplos

O exemplo de código a seguir demonstra uma operação de arrastar e soltar entre dois ListBox controles. O exemplo chama o DoDragDrop método quando a ação de arrastar é iniciada. A ação de arrastar será iniciada se o mouse tiver se movido mais do que SystemInformation.DragSize do local do mouse durante o MouseDown evento. O IndexFromPoint método é usado para determinar o índice do item a ser arrastado durante o MouseDown evento.

O exemplo também demonstra o uso de cursores personalizados para a operação de arrastar e soltar. O exemplo requer que dois arquivos 3dwarro.cur de cursor e 3dwno.cur, existam no diretório do aplicativo, para os cursores de arrastar e sem soltar personalizados, respectivamente. Os cursores personalizados serão usados se for UseCustomCursorsCheckCheckBox verificado. Os cursores personalizados são definidos no GiveFeedback manipulador de eventos.

O estado do teclado é avaliado no DragOver manipulador de eventos à direita ListBox, para determinar qual operação de arrastar será baseada no estado das teclas SHIFT, CTRL, ALT ou CTRL+ALT. O local no local em ListBox que a queda ocorreria também é determinado durante o DragOver evento. Se os dados a serem removidos não forem um String, o DragEventArgs.Effect valor será definido None como DragDropEffects. Por fim, o status da queda é exibido no DropLocationLabelLabel.

Os dados a serem removidos para a direita ListBox são determinados no DragDrop manipulador de eventos e o String valor é adicionado no local apropriado no ListBox. Se a operação de arrastar se mover para fora dos limites do formulário, a operação de arrastar e soltar será cancelada no QueryContinueDrag manipulador de eventos.

Este trecho de código demonstra o uso do DragLeave evento. Consulte o DoDragDrop método para obter o exemplo de código completo.

void ListDragTarget_DragLeave( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
  // Reset the label text.
   DropLocationLabel->Text = "None";
}

private void ListDragTarget_DragLeave(object sender, EventArgs e)
{
    // Reset the label text.
    DropLocationLabel.Text = "None";
}

Private Sub ListDragTarget_DragLeave(ByVal sender As Object, ByVal e As EventArgs) Handles ListDragTarget.DragLeave
    ' Reset the label text.
    DropLocationLabel.Text = "None"
End Sub

Comentários

O DragLeave evento é gerado quando o usuário arrasta o cursor para fora do controle ou o usuário cancela a operação de arrastar e soltar atual.

A seguir, descreve como e quando eventos relacionados a operações de arrastar e soltar são gerados.

O DoDragDrop método determina o controle sob o local atual do cursor. Em seguida, verifica se o controle é um destino suspenso válido.

Se o controle for um destino suspenso válido, o GiveFeedback evento será gerado com o efeito de arrastar e soltar especificado. Para obter uma lista de efeitos de arrastar e soltar, consulte a DragDropEffects enumeração.

As alterações na posição do cursor do mouse, no estado do teclado e no estado do botão do mouse são controladas.

• Se o usuário sair de uma janela, o DragLeave evento será gerado.

• Se o mouse entrar em outro controle, o DragEnter controle será acionado.

• Se o mouse se mover, mas permanecer dentro do mesmo controle, o DragOver evento será gerado.

Se houver uma alteração no estado do botão do teclado ou do mouse, o QueryContinueDrag evento será acionado e determinará se deseja continuar a arrastar, remover os dados ou cancelar a operação com base no valor da Action propriedade do QueryContinueDragEventArgsevento.

• Se o valor DragAction for, o DragOver evento será gerado para continuar a operação e o GiveFeedback evento será gerado com o novo efeito para que os comentários visuais apropriados possam Continueser definidos. Para obter uma lista de efeitos suspensos válidos, consulte a DragDropEffects enumeração.

  Nota

  Os DragOver eventos e GiveFeedback os eventos são emparelhados para que, à medida que o mouse se move pelo destino suspenso, o usuário recebe os comentários mais up-to-date sobre a posição do mouse.

• Se o valor forDrop, o valor do DragAction efeito de queda será retornado para a origem, para que o aplicativo de origem possa executar a operação apropriada nos dados de origem; por exemplo, corte os dados se a operação for uma movimentação.

• Se o valor for DragActionCancel, o DragLeave evento será gerado.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Confira também

• OnDragLeave(EventArgs)