QueryContinueDragEventHandler (Delegado)
Actualización: noviembre 2007
Representa el método que controlará el evento QueryContinueDrag de Control.
Ensamblado: System.Windows.Forms (en System.Windows.Forms.dll)
public delegate void QueryContinueDragEventHandler( Object sender, QueryContinueDragEventArgs e )
/** @delegate */ public delegate void QueryContinueDragEventHandler( Object sender, QueryContinueDragEventArgs e )
Parámetros
- sender
- Tipo: System.Object
Origen de un evento.
- e
- Tipo: System.Windows.Forms.QueryContinueDragEventArgs
QueryContinueDragEventArgs que contiene los datos del evento.
Cuando se crea un delegado QueryContinueDragEventHandler, se identifica el método que controlará el evento. Para asociar el evento al controlador de eventos, se debe agregar una instancia del delegado al evento. Se llama al controlador de eventos siempre que se produce el evento, a menos que se quite el delegado. Para obtener más información sobre cómo controlar eventos con delegados, vea Eventos y delegados.
En el siguiente ejemplo 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 se ha movido el mouse más de SystemInformation.DragSize desde su ubicación durante el evento MouseDown. El método IndexFromPoint se utiliza para determinar el índice del elemento que se va a arrastrar durante el evento MouseDown.
En el ejemplo también se muestra la forma de utilizar cursores personalizados para la operación de arrastrar y colocar. En este ejemplo, se supone que hay dos archivos de cursor (3dwarro.cur y 3dwno.cur) en el directorio de la aplicación para los cursores de arrastrar y colocar personalizados, respectivamente. Los cursores personalizados se utilizan si se ha activado UseCustomCursorsCheckCheckBox. Los cursores personalizados se establecen en el controlador de eventos GiveFeedback.
Se evalúa el estado del teclado en el controlador de eventos DragOver para averiguar si el control ListBox es correcto, a fin de determinar qué operación de arrastrar se realizará, en función del estado de las teclas MAYÚS, CTRL, ALT o CTRL+ALT. La ubicación de ListBox en la que se produciría la operación de colocar también se determina durante el evento DragOver. Si los datos que se van a colocar no son de tipo String, el valor de la propiedad DragEventArgs.Effect se establece en DragDropEffects.None. Por último, el estado de la operación de colocar se muestra en DropLocationLabelLabel.
Los datos que se colocan para el control ListBox correcto se determinan en el controlador de eventos DragDrop y el valor String se incluye en la ubicación apropiada del control ListBox. Si la operación de arrastrar se realiza fuera de los límites del formulario, la operación de arrastrar y colocar se cancelará en el controlador de eventos QueryContinueDrag.
En este fragmento de código se muestra la utilización del delegado QueryContinueDragEventHandler con el evento QueryContinueDrag. Para obtener el ejemplo completo del código, vea el método DoDragDrop.
private void ListDragSource_QueryContinueDrag(object sender, System.Windows.Forms.QueryContinueDragEventArgs e) { // Cancel the drag if the mouse moves off the form. ListBox lb = sender as ListBox; if (lb != null) { Form f = lb.FindForm(); // Cancel the drag if the mouse moves off the form. The screenOffset // takes into account any desktop bands that may be at the top or left // side of the screen. if (((Control.MousePosition.X - screenOffset.X) < f.DesktopBounds.Left) || ((Control.MousePosition.X - screenOffset.X) > f.DesktopBounds.Right) || ((Control.MousePosition.Y - screenOffset.Y) < f.DesktopBounds.Top) || ((Control.MousePosition.Y - screenOffset.Y) > f.DesktopBounds.Bottom)) { e.Action = DragAction.Cancel; } } }
private void listDragSource_QueryContinueDrag(Object sender,
System.Windows.Forms.QueryContinueDragEventArgs e)
{
// Cancel the drag if the mouse moves off the form.
ListBox lb = (ListBox)sender;
if (lb != null) {
Form f = lb.FindForm();
// Cancel the drag if the mouse moves off the form. The
// screenOffset takes into account any desktop bands
// that may be at the top or left side of the screen.
if (Control.get_MousePosition().get_X() - screenOffset.get_X()
< f.get_DesktopBounds().get_Left()
|| Control.get_MousePosition().get_X()
- screenOffset.get_X() > f.get_DesktopBounds().get_Right()
|| Control.get_MousePosition().get_Y() - screenOffset.get_Y()
< f.get_DesktopBounds().get_Top()
|| Control.get_MousePosition().get_Y() - screenOffset.get_Y()
> f.get_DesktopBounds().get_Bottom()) {
e.set_Action(DragAction.Cancel);
}
}
} //listDragSource_QueryContinueDrag
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
