ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag ToolStripItem.QueryContinueDrag Event

Definición

Se produce durante una operación de arrastrar y colocar y permite al origen de arrastre determinar si la operación de arrastrar y colocar tiene que cancelarse.Occurs during a drag-and-drop operation and allows the drag source to determine whether the drag-and-drop operation should be canceled.

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

Ejemplos

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 de la QueryContinueDrag eventos.In the example, an event handler reports on the occurrence of the QueryContinueDrag event. Este informe le ayuda a saber cuándo el evento se produce y puede ayudarle a depurar.This report helps you to learn when the event occurs and can assist you in debugging. Para informar sobre varios eventos o en eventos que se producen con frecuencia, considere reemplazar MessageBox.Show con Console.WriteLine o agregar el mensaje a un multilínea 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 ejecutar el ejemplo de código, péguelo en un proyecto que contiene una instancia de un tipo que hereda 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 a la instancia ToolStripItem1 y asegúrese de que está asociado el controlador de eventos con el QueryContinueDrag eventos.Then name the instance ToolStripItem1 and ensure that the event handler is associated with the QueryContinueDrag event.

private void ToolStripItem1_QueryContinueDrag(Object sender, QueryContinueDragEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "KeyState", e.KeyState );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "EscapePressed", e.EscapePressed );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Action", e.Action );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "QueryContinueDrag Event" );
}
Private Sub ToolStripItem1_QueryContinueDrag(sender as Object, e as QueryContinueDragEventArgs) _ 
     Handles ToolStripItem1.QueryContinueDrag

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "KeyState", e.KeyState)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "EscapePressed", e.EscapePressed)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Action", e.Action)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"QueryContinueDrag Event")

End Sub

Comentarios

El QueryContinueDrag evento se desencadena cuando hay un cambio en el estado del teclado o mouse durante una operación de arrastrar y colocar.The QueryContinueDrag event is raised when there is a change in the keyboard or mouse button state during a drag-and-drop operation. El QueryContinueDrag evento permite que el origen de arrastre determinar si la operación de arrastrar y colocar tiene que cancelarse.The QueryContinueDrag event allows the drag source to determine whether the drag-and-drop operation should be canceled.

Los comentarios siguientes describen cómo y cuándo se producen los eventos relacionados con 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 válido, el GiveFeedback se provoca el evento 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 cambios en la posición del cursor del mouse, el estado del teclado y el estado de botón del mouse en 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, el DragEnter para ese control se genera.If the mouse enters another item, the DragEnter for that control is raised.

  • Si mueve el mouse pero permanece dentro del mismo elemento, el DragOver provoca 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 botón teclado o mouse, el QueryContinueDrag se provoca el evento y determina si 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 evento QueryContinueDragEventArgs.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, DragOver evento se provoca para continuar con la operación y el GiveFeedback evento se genera con el nuevo efecto, por lo que se puede establecer la información visual apropiada.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.

El DragOver y GiveFeedback eventos están emparejados de forma que cuando el mouse se desplace por el destino de colocación, el usuario reciba 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 colocar se devuelve al origen, para que la aplicación de origen pueda realizar la operación apropiada en los datos de origen; por ejemplo, cortar los datos si la operación es 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, el DragLeave provoca el evento.If the value of DragAction is Cancel, the DragLeave event is raised.

Se aplica a