ToolStripItem.DragLeave Evento

Definição

Ocorre quando o usuário arrasta um item e o ponteiro do mouse não está mais na área de cliente desse item.Occurs when the user drags an item and the mouse pointer is no longer over the client area of this item.

public:
 event EventHandler ^ DragLeave;
[System.ComponentModel.Browsable(false)]
public event EventHandler DragLeave;
member this.DragLeave : EventHandler 
Public Custom Event DragLeave As EventHandler 
Atributos

Exemplos

O exemplo de código a seguir demonstra o uso desse membro.The following code example demonstrates the use of this member. No exemplo, um manipulador de eventos relata a ocorrência do DragLeave evento.In the example, an event handler reports on the occurrence of the DragLeave event. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração.This report helps you to learn when the event occurs and can assist you in debugging. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.Show Console.WriteLine ou anexar a mensagem a uma multilinha TextBox.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Para executar o código de exemplo, Cole-o em um projeto que contém uma instância de um tipo que ToolStripItemherda de, como ToolStripButton um ToolStripMenuItemou.To run the example code, paste it into a project that contains an instance of a type that inherits from ToolStripItem, such as a ToolStripButton or ToolStripMenuItem. Em seguida, nomeie ToolStripItem1 a instância e verifique se o manipulador de eventos está DragLeave associado ao evento.Then name the instance ToolStripItem1 and ensure that the event handler is associated with the DragLeave event.

private void ToolStripItem1_DragLeave(Object sender, EventArgs e) {

   MessageBox.Show("You are in the ToolStripItem.DragLeave event.");

}
Private Sub ToolStripItem1_DragLeave(sender as Object, e as EventArgs) _ 
     Handles ToolStripItem1.DragLeave

   MessageBox.Show("You are in the ToolStripItem.DragLeave event.")

End Sub

Comentários

O evento DragLeave é gerado quando o usuário arrasta o cursor fora do controle ou o usuário cancela a operação do tipo "arrastar e soltar" atual.The DragLeave event is raised when the user drags the cursor out of the control or the user cancels the current drag-and-drop operation.

Os comentários a seguir descrevem como e quando eventos relacionados a operações de arrastar e soltar são gerados.The following remarks describe how and when events related to drag-and-drop operations are raised.

O DoDragDrop método determina o item sob o local do cursor atual.The DoDragDrop method determines the item under the current cursor location. Em seguida, ele verifica se o item é um destino de soltura válido.It then checks to see if the item is a valid drop target.

Se o item for um destino de soltura válido, GiveFeedback o evento será gerado com o efeito de arrastar e soltar especificado.If the item is a valid drop target, the GiveFeedback event is raised with the drag-and-drop effect specified. Para obter uma lista de efeitos de arrastar e soltar, consulte a DragDropEffects enumeração.For a list of drag-and-drop effects, see the DragDropEffects enumeration.

As alterações na posição do cursor do mouse, no estado do teclado e no estado do botão do mouse são rastreadas da seguinte maneira:Changes in the mouse cursor position, keyboard state, and mouse button state are tracked in the following manner:

  • Se o usuário sai de uma janela, o DragLeave evento é gerado.If the user moves out of a window, the DragLeave event is raised.

  • Se o mouse entrar em outro item, DragEnter o para esse controle será gerado.If the mouse enters another item, the DragEnter for that control is raised.

  • Se o mouse se mover, mas permanecer dentro do mesmo item DragOver , o evento será gerado.If the mouse moves but stays within the same item, the DragOver event is raised.

Se houver uma alteração no estado do botão do mouse ou do teclado, QueryContinueDrag o evento será gerado e determinará se deseja continuar a arrastar, para descartar os dados ou para cancelar a operação com base no Action valor da QueryContinueDragEventArgsPropriedade do evento.If there is a change in the keyboard or mouse button state, the QueryContinueDrag event is raised and determines whether to continue the drag, to drop the data, or to cancel the operation based on the value of the Action property of the event's QueryContinueDragEventArgs.

Se o valor de DragAction for Continue, o DragOver evento será gerado para continuar a operação e o GiveFeedback evento será gerado com o novo efeito, de modo que os comentários visuais apropriados possam ser definidos.If the value of DragAction is Continue, the DragOver event is raised to continue the operation and the GiveFeedback event is raised with the new effect so appropriate visual feedback can be set. Para obter uma lista de efeitos de remoção válidos, DragDropEffects consulte a enumeração.For a list of valid drop effects, see the DragDropEffects enumeration.

Os DragOver eventos GiveFeedback e são emparelhados de forma que, à medida que o mouse se move entre o destino de soltura, o usuário recebe os comentários mais atualizados sobre a posição do mouse, da seguinte maneira:The DragOver and GiveFeedback events are paired so that as the mouse moves across the drop target, the user is given the most up-to-date feedback on the mouse's position, as follows:

  • Se o valor de DragAction for Drop, o valor do efeito de soltar será retornado para a origem, de modo que o aplicativo de origem poderá executar a operação apropriada nos dados de origem; por exemplo, recortar os dados se a operação foi movida.If the value of DragAction is Drop, the drop effect value is returned to the source, so the source application can perform the appropriate operation on the source data; for example, cut the data if the operation was a move.

  • Se o valor de DragAction for Cancel, o DragLeave evento será gerado.If the value of DragAction is Cancel, the DragLeave event is raised.

Aplica-se a