ToolStripItem.DragEnter Evento

Definición

Se produce cuando el usuario arrastra un elemento al área cliente de este elemento.Occurs when the user drags an item into the client area of this item.

public:
 event System::Windows::Forms::DragEventHandler ^ DragEnter;
[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.DragEventHandler DragEnter;
member this.DragEnter : System.Windows.Forms.DragEventHandler 
Public Custom Event DragEnter As DragEventHandler 
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo X convertir Y las propiedades y en Pointun cliente.The following code example shows how to convert the X and Y properties to a client Point. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado ToolStripRenderer para la clase.This code example is part of a larger example provided for the ToolStripRenderer class.

// This method defines the DragOver event behavior. 
protected override void OnDragOver(DragEventArgs dea)
{
    base.OnDragOver(dea);

    // Get the ToolStripButton control 
    // at the given mouse position.
    Point p = new Point(dea.X, dea.Y);
    ToolStripButton item = this.GetItemAt(
        this.PointToClient(p)) as ToolStripButton;

    // If the ToolStripButton control is the empty cell,
    // indicate that the move operation is valid.
    if( item == this.emptyCellButton )
    {
        // Set the drag operation to indicate a valid move.
        dea.Effect = DragDropEffects.Move;
    }
}
' This method defines the DragOver event behavior. 
Protected Overrides Sub OnDragOver(dea As DragEventArgs)
   MyBase.OnDragOver(dea)
   
   ' Get the ToolStripButton control 
   ' at the given mouse position.
   Dim p As New Point(dea.X, dea.Y)
   Dim item As ToolStripButton = CType(Me.GetItemAt(Me.PointToClient(p)), ToolStripButton)
   
   
   ' If the ToolStripButton control is the empty cell,
   ' indicate that the move operation is valid.
     If item Is Me.emptyCellButton Then
         ' Set the drag operation to indicate a valid move.
         dea.Effect = DragDropEffects.Move
     End If
 End Sub

Comentarios

El DragEnter evento se genera cuando el usuario arrastra por primera vez el cursor del mouse sobre el elemento durante una operación de arrastrar y colocar.The DragEnter event is raised when the user first drags the mouse cursor over the item during a 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 DoDragDrop método 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, GiveFeedback el evento se genera 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 DragEnter en otro elemento, se genera 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, DragOver se genera el evento.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 QueryContinueDrag genera el evento y determina si se debe continuar la operación de arrastrar, colocar los datos o cancelar la operación en función del valor de la Action propiedad del del QueryContinueDragEventArgsevento.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 DragOver genera el evento para continuar con la operación y GiveFeedback el evento 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 DragOver eventos GiveFeedback y están emparejados de forma que cuando el mouse se desplace por el destino de colocación, al usuario se le proporcione 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, cortar 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 DragLeave genera el evento.If the value of DragAction is Cancel, the DragLeave event is raised.

Nota

Las X propiedades Y y deDragEventArgs están en coordenadas de pantalla, no en coordenadas de cliente.The X and Y properties of the DragEventArgs are in screen coordinates, not client coordinates.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.For more information about handling events, see Handling and Raising Events.

Se aplica a