ToolStripItem.DragLeave Event

Definition

Se produce cuando el usuario arrastra un elemento y el puntero del mouse ya no está sobre el área cliente de este elemento.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 
Attributes

Examples

En el ejemplo de código siguiente se muestra el uso de este miembro.The following code example demonstrates the use of this member. En el ejemplo, un controlador de eventos informa sobre la aparición del evento DragLeave.In the example, an event handler reports on the occurrence of the DragLeave event. Este informe le ayuda a saber cuándo se produce el evento y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para notificar varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.Show por Console.WriteLine o anexar el mensaje a un TextBoxmultilínea.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 ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de un tipo que herede de ToolStripItem, como un ToolStripButton o ToolStripMenuItem.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. A continuación, asigne un nombre a la instancia ToolStripItem1 y asegúrese de que el controlador de eventos está asociado al evento DragLeave.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

Remarks

El evento DragLeave se genera cuando el usuario arrastra el cursor fuera del control o el usuario cancela la operación de arrastrar y colocar actual.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.

En las notas siguientes se describe cómo y cuándo se generan los eventos relacionados con las operaciones de arrastrar y colocar.The following remarks describe how and when events related to drag-and-drop operations are raised.

El método DoDragDrop determina el elemento en la ubicación actual del cursor.The DoDragDrop method determines the item under the current cursor location. A continuación, comprueba si el elemento es un destino de colocación válido.It then checks to see if the item is a valid drop target.

Si el elemento es un destino de colocación válido, se genera el evento GiveFeedback con el efecto de arrastrar y colocar especificado.If the item is a valid drop target, the GiveFeedback event is raised with the drag-and-drop effect specified. Para obtener una lista de efectos de arrastrar y colocar, vea la enumeración DragDropEffects.For a list of drag-and-drop effects, see the DragDropEffects enumeration.

Se realiza un seguimiento de los cambios en la posición del cursor del mouse, el estado del teclado y el estado del botón del mouse de la siguiente manera:Changes in the mouse cursor position, keyboard state, and mouse button state are tracked in the following manner:

  • Si el usuario desplaza el mouse fuera de una ventana, se genera el evento DragLeave.If the user moves out of a window, the DragLeave event is raised.

  • Si el Mouse entra en otro elemento, se genera el DragEnter para ese control.If the mouse enters another item, the DragEnter for that control is raised.

  • Si el mouse se mueve pero permanece dentro del mismo elemento, se genera el evento DragOver.If the mouse moves but stays within the same item, the DragOver event is raised.

Si hay un cambio en el estado del teclado o del mouse, se genera el evento QueryContinueDrag y se determina si se continúa la operación de arrastrar, se colocan los datos o si se cancela la operación en función del valor de la propiedad Action de la QueryContinueDragEventArgsdel 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.

Si el valor de DragAction es Continue, se genera el evento DragOver para continuar con la operación y el evento de GiveFeedback se genera con el nuevo efecto para que se puedan establecer los comentarios visuales adecuados.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 obtener una lista de efectos de colocar válidos, vea la enumeración DragDropEffects.For a list of valid drop effects, see the DragDropEffects enumeration.

Los eventos DragOver y GiveFeedback se emparejan de modo que cuando el mouse se mueve por el destino de colocación, el usuario recibe la información más actualizada sobre la posición del mouse, como se indica a continuación: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:

  • Si el valor de DragAction es Drop, el valor del efecto de colocación se devuelve al origen, por lo que la aplicación de origen puede realizar la operación adecuada en los datos de origen; por ejemplo, corte los datos si la operación fuera un movimiento.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.

  • Si el valor de DragAction es Cancel, se genera el evento DragLeave.If the value of DragAction is Cancel, the DragLeave event is raised.

Applies to