ToolStripItem.DragOver Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando el usuario arrastra un elemento sobre el área cliente de este elemento.

public:
 event System::Windows::Forms::DragEventHandler ^ DragOver;

[System.ComponentModel.Browsable(false)]
public event System.Windows.Forms.DragEventHandler? DragOver;

[<System.ComponentModel.Browsable(false)>]
member this.DragOver : System.Windows.Forms.DragEventHandler 

Public Custom Event DragOver As DragEventHandler 

Tipo de evento

DragEventHandler

Atributos

BrowsableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos informa sobre la aparición del DragOver evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.ShowConsole.WriteLine por o anexar el mensaje a una línea TextBoxmúltiple.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de un tipo que herede de ToolStripItem, como o ToolStripMenuItemToolStripButton . A continuación, asigne un nombre a la instancia ToolStripItem1 y asegúrese de que el controlador de eventos está asociado al DragOver evento.

private void ToolStripItem1_DragOver(Object sender, DragEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Data", e.Data );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "KeyState", e.KeyState );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "X", e.X );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Y", e.Y );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "AllowedEffect", e.AllowedEffect );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Effect", e.Effect );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "DragOver Event" );
}

Private Sub ToolStripItem1_DragOver(sender as Object, e as DragEventArgs) _ 
     Handles ToolStripItem1.DragOver

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Data", e.Data)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyState", e.KeyState)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "X", e.X)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Y", e.Y)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "AllowedEffect", e.AllowedEffect)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Effect", e.Effect)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"DragOver Event")

End Sub

Comentarios

El DragOver evento se genera cuando el cursor del mouse se mueve dentro de los límites del control durante una operación de arrastrar y colocar.

En los comentarios siguientes se describe cómo y cuándo se generan los eventos relacionados con las operaciones de arrastrar y colocar.

El DoDragDrop método determina el elemento bajo la ubicación actual del cursor. A continuación, comprueba si el elemento es un destino de colocación válido.

Si el elemento es un destino de colocación válido, el GiveFeedback evento se genera con el efecto de arrastrar y colocar especificado. Para obtener una lista de efectos de arrastrar y colocar, vea la enumeración DragDropEffects.

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:

• Si el usuario desplaza el mouse fuera de una ventana, se genera el evento DragLeave.

• Si el mouse entra en otro elemento, se genera para DragEnter ese control.

• Si el mouse se mueve pero permanece dentro del mismo elemento, se genera el DragOver evento .

Si hay un cambio en el estado del teclado o del botón del mouse, se genera el QueryContinueDrag evento y determina si se debe continuar con la arrastrar, colocar los datos o cancelar la operación en función del valor de la Action propiedad del evento QueryContinueDragEventArgs.

Si el valor de DragAction es Continue, se genera el DragOver evento para continuar con la operación y el GiveFeedback evento se genera con el nuevo efecto para que se puedan establecer los comentarios visuales adecuados. Para obtener una lista de efectos de colocar válidos, vea la enumeración DragDropEffects.

Los DragOver eventos y GiveFeedback se emparejan para que, a medida que el mouse se mueve a través del destino de colocación, el usuario recibe los comentarios más actualizados sobre la posición del mouse, como se indica a continuación:

• Si el valor de DragAction es Drop, el valor de 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 era un movimiento.

• Si el valor de DragAction es Cancel, se genera el DragLeave evento .