Control.GiveFeedback Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce durante una operación de arrastre.
public:
event System::Windows::Forms::GiveFeedbackEventHandler ^ GiveFeedback;public event System.Windows.Forms.GiveFeedbackEventHandler GiveFeedback;public event System.Windows.Forms.GiveFeedbackEventHandler? GiveFeedback;member this.GiveFeedback : System.Windows.Forms.GiveFeedbackEventHandler Public Custom Event GiveFeedback As GiveFeedbackEventHandler Tipo de evento
Ejemplos
En el ejemplo de código siguiente se muestra una operación de arrastrar y colocar entre dos controles ListBox. En el ejemplo se llama al método DoDragDrop cuando se inicia la acción de arrastrar. La acción de arrastrar se inicia si el mouse se ha movido más de SystemInformation.DragSize desde la ubicación del mouse durante el evento MouseDown. El método IndexFromPoint se usa para determinar el índice del elemento que se va a arrastrar durante el evento MouseDown.
En el ejemplo también se muestra el uso de cursores personalizados para la operación de arrastrar y colocar. El ejemplo requiere que dos archivos de cursor, 3dwarro.cur y 3dwno.cur, existan en el directorio de la aplicación, para los cursores de arrastrar y sin colocar personalizados, respectivamente. Los cursores personalizados se usarán si se comprueba el UseCustomCursorsCheckCheckBox. Los cursores personalizados se establecen en el controlador de eventos GiveFeedback.
El estado del teclado se evalúa en el controlador de eventos DragOver de la derecha ListBox, para determinar cuál será la operación de arrastre en función del estado de las teclas MAYÚS, CTRL, ALT o CTRL+ALT. La ubicación del ListBox donde se produciría la eliminación también se determina durante el evento DragOver. Si los datos que se van a quitar no son un String, el DragEventArgs.Effect se establece en None en DragDropEffects. Por último, el estado de la colocación se muestra en el DropLocationLabelLabel.
Los datos que se van a quitar de la ListBox derecha se determinan en el controlador de eventos DragDrop y el valor de String se agrega en el lugar adecuado de la ListBox. Si la operación de arrastre se mueve fuera de los límites del formulario, la operación de arrastrar y colocar se cancela en el controlador de eventos QueryContinueDrag.
Este fragmento de código muestra el uso del evento GiveFeedback. Consulte el método DoDragDrop para obtener el ejemplo de código completo.
void ListDragSource_GiveFeedback( Object^ /*sender*/, System::Windows::Forms::GiveFeedbackEventArgs^ e )
{
// Use custom cursors if the check box is checked.
if ( UseCustomCursorsCheck->Checked )
{
// Sets the custom cursor based upon the effect.
e->UseDefaultCursors = false;
if ( (e->Effect & DragDropEffects::Move) == DragDropEffects::Move )
::Cursor::Current = MyNormalCursor;
else
::Cursor::Current = MyNoDropCursor;
}
}
private void ListDragSource_GiveFeedback(object sender, GiveFeedbackEventArgs e)
{
// Use custom cursors if the check box is checked.
if (UseCustomCursorsCheck.Checked)
{
// Sets the custom cursor based upon the effect.
e.UseDefaultCursors = false;
if ((e.Effect & DragDropEffects.Move) == DragDropEffects.Move)
Cursor.Current = MyNormalCursor;
else
Cursor.Current = MyNoDropCursor;
}
}
Private Sub ListDragSource_GiveFeedback(ByVal sender As Object, ByVal e As GiveFeedbackEventArgs) Handles ListDragSource.GiveFeedback
' Use custom cursors if the check box is checked.
If (UseCustomCursorsCheck.Checked) Then
' Set the custom cursor based upon the effect.
e.UseDefaultCursors = False
If ((e.Effect And DragDropEffects.Move) = DragDropEffects.Move) Then
Cursor.Current = MyNormalCursor
Else
Cursor.Current = MyNoDropCursor
End If
End If
End Sub
Comentarios
El evento GiveFeedback se genera cuando se inicia una operación de arrastrar y colocar. Con el evento GiveFeedback, el origen de un evento de arrastre puede modificar la apariencia del puntero del mouse para proporcionar al usuario comentarios visuales durante una operación de arrastrar y colocar.
A continuación se describe cómo y cuándo se generan eventos relacionados con las operaciones de arrastrar y colocar.
El método DoDragDrop determina el control bajo la ubicación actual del cursor. A continuación, comprueba si el control es un destino de colocación válido.
Si el control es un destino de colocación válido, el evento GiveFeedback se genera con el efecto de arrastrar y colocar especificado. Para obtener una lista de efectos de arrastrar y colocar, consulte 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.
Si el usuario sale de una ventana, se genera el evento DragLeave.
Si el mouse entra en otro control, se genera el DragEnter de ese control.
Si el mouse se mueve pero permanece dentro del mismo control, se genera el evento DragOver.
Si hay un cambio en el estado del teclado o del botón del mouse, se genera el evento QueryContinueDrag y determina si se va a continuar con la arrastrar, colocar los datos o cancelar la operación en función del valor de la propiedad Action del QueryContinueDragEventArgsdel evento.
Si el valor de DragAction es
Continue, se genera el evento DragOver para continuar con la operación y el evento GiveFeedback se genera con el nuevo efecto para que se puedan establecer los comentarios visuales adecuados. Para obtener una lista de efectos de colocación válidos, consulte la enumeración DragDropEffects.Nota
Los eventos DragOver y GiveFeedback se emparejan para que, a medida que el mouse se mueva a través del destino de colocación, el usuario recibe los comentarios más up-to-date en la posición del mouse.
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 evento DragLeave.
Para obtener más información sobre cómo controlar eventos, vea control y generación de eventos.
