Evento BeforeDragOver
Se produce cuando hay una operación de arrastrar y soltar en curso.
Sintaxis
Para frame
Objeto Private Sub_BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ctrlComo control,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
Efecto ByValcomo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para MultiPage
Private Subobject _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ctrlComo control,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
Efecto ByValcomo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para TabStrip
Private Subobject _BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
Efecto ByValcomo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para otros controles
Objeto Private Sub_BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYAs Single,
ByValDragStateAs fmDragState,
Efecto ByValcomo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
La sintaxis del evento BeforeDragOver consta de las siguientes partes:
| Parte | Descripción |
|---|---|
| object | Obligatorio. Nombre de objeto válido. |
| index | Obligatorio. Índice de la página en una multipágina a la que afectará la operación de arrastrar y colocar. |
| Cancel | Obligatorio. Estado del evento. False indica que el control debe administrar el evento (predeterminado). True indica que la aplicación es la que controla el evento. |
| Ctrl | Obligatorio. Control que se está arrastrando. |
| Datos | Obligatorio. Datos que se arrastran en la operación de arrastrar y soltar. Los datos se empaquetan en un objeto DataObject. |
| X, Y | Obligatorio. Coordenadas horizontales y verticales de la posición del control. Ambas coordenadas se miden en puntos. X se mide desde el borde izquierdo del control; mientras que Y se mide desde la parte superior del control. |
| DragState | Obligatorio. Estado de transición de los datos que se están arrastrando. |
| Effect | Obligatorio. Operaciones admitidas por el origen de los datos soltados. |
| Shift | Obligatorio. Especifica el estado de las teclas MAYÚS., CTRL y ALT. |
Configuración
Los valores para DragState son los siguientes:
| Constante | Valor | Descripción |
|---|---|---|
| fmDragStateEnter | 0 | El puntero del mouse está dentro del rango del destino. |
| fmDragStateLeave | 1 | El puntero del mouse está fuera del rango del destino. |
| fmDragStateOver | 2 | El puntero del mouse está en una posición nueva, pero permanece dentro del rango del mismo destino. |
Los valores para Effect son los siguientes:
| Constante | Valor | Descripción |
|---|---|---|
| fmDropEffectNone | 0 | No se copia ni se mueve el origen de los datos soltados al destino |
| fmDropEffectCopy | 1 | Copia el origen de colocación en el destino de colocación. |
| fmDropEffectMove | 2 | Mueve el origen de colocación al destino de colocación. |
| fmDropEffectCopyOrMove | 3 | Copia o mueve el origen de colocación en el destino de colocación. |
Los valores para Shift son los siguientes:
| Constante | Valor | Descripción |
|---|---|---|
| fmShiftMask | 1 | Se presionó la tecla MAYÚS. |
| fmCtrlMask | 2 | Se presionó la tecla CTRL. |
| fmAltMask | 4 | Se presionó la tecla ALT. |
Comentarios
Use este evento para supervisar el puntero del mouse a medida que entra, sale o se encuentra directamente sobre un destino válido. Cuando una operación de arrastrar y soltar está en curso, el sistema inicia este evento cuando el usuario mueve el mouse, o cuando presiona o suelta algún botón del mouse. La posición del puntero del mouse determina el objeto de destino que recibe este evento. Puede determinar el estado del puntero del mouse con el argumento DragState.
Cuando un control es el que controla este evento, puede usar el argumento Effect para identificar la acción de arrastrar y soltar que se va a realizar.
Cuando Effect está configurado en fmDropEffectCopyOrMove, el origen de los datos soltados admite la copia (fmDropEffectCopy), el movimiento (fmDropEffectMove) o la cancelación (fmDropEffectNone).
Cuando Effect está configurado como fmDropEffectCopy, el origen de los datos soltados admite la copia o la cancelación (fmDropEffectNone).
Cuando Effect está configurado como fmDropEffectMove, el origen de los datos soltados admite el movimiento o la cancelación (fmDropEffectNone).
Cuando Effect se establece en fmDropEffectNone, el origen de colocación admite una operación de cancelación.
La mayoría de los controles no admiten arrastrar y colocar mientras Cancel es False, que es la configuración predeterminada. Esto significa que el control rechaza los intentos de arrastrar o colocar cualquier cosa en el control y el control no inicia el evento BeforeDropOrPaste. Los controles TextBox y ComboBox son excepciones a esto; estos controles admiten operaciones de arrastrar y colocar incluso cuando Cancel es False.
Consulte también
Soporte técnico y comentarios
¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.