Evento BeforeDragOver
Ocorre quando uma operação de arrastar e soltar está em andamento.
Sintaxe
Para Quadro
Objeto Sub privado_BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ctrlcomo controle,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo single,
ByValDragStateComo fmDragState,
Efeito ByValcomo MSForms.ReturnEffect,
ByValShiftComo fmShiftState)
Para MultiPage
Objeto Sub privado_BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ctrlcomo controle,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo single,
ByValDragStateComo fmDragState,
Efeito ByValcomo MSForms.ReturnEffect,
ByValShiftComo fmShiftState)
Para TabStrip
Objeto Sub privado_BeforeDragOver(indexAs Long,
ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo single,
ByValDragStateComo fmDragState,
Efeito ByValcomo MSForms.ReturnEffect,
ByValShiftComo fmShiftState)
Para outros controles
Objeto Sub privado_BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo single,
ByValDragStateComo fmDragState,
Efeito ByValcomo MSForms.ReturnEffect,
ByValShiftComo fmShiftState)
A sintaxe de evento BeforeDragOver tem estas partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Um nome de objeto válido. |
| índice | Obrigatório. O índice da Página em uma MultiPage que a operação de arrastar e soltar afetará. |
| Cancel | Obrigatório. Status do evento. False indica que o controle deve lidar com o evento (padrão). True indica que o aplicativo manipula o evento. |
| Ctrl | Obrigatório. O controle que está sendo arrastado. |
| Dados | Obrigatório. Dados arrastados em uma operação de arrastar e soltar. Os dados são empacotados em um DataObject. |
| X, Y | Obrigatório. As coordenadas horizontais e verticais da posição do controle. Ambas as coordenadas são medidas em pontos. X é medido da borda esquerda do controle; Y é medido da parte superior do controle.. |
| DragState | Obrigatório. Estado de transição dos dados que estão sendo arrastados. |
| Effect | Obrigatório. Operações compatíveis com a origem de drop. |
| Shift | Obrigatório. Especifica o estado de SHIFT, CTRL e ALT. |
Configurações
As configurações para DragState são:
| Constant | Valor | Descrição |
|---|---|---|
| fmDragStateEnter | 0 | O ponteiro do mouse está dentro do intervalo de um destino. |
| fmDragStateLeave | 1 | O ponteiro do mouse está fora do intervalo de um destino. |
| fmDragStateOver | 2 | O ponteiro do mouse está em uma nova posição, mas permanece dentro do intervalo do mesmo destino. |
As configurações para Efeito são:
| Constant | Valor | Descrição |
|---|---|---|
| fmDropEffectNone | 0 | Não copia nem move a origem de drop para o destino suspenso. |
| fmDropEffectCopy | 1 | Copia a fonte de entrega para o destino de queda. |
| fmDropEffectMove | 2 | Move a fonte de queda para o destino de queda. |
| fmDropEffectCopyOrMove | 3 | Copia ou move a fonte de entrega para o destino suspenso. |
As configurações de Shift são:
| Constant | Valor | Descrição |
|---|---|---|
| fmShiftMask | 1 | SHIFT foi pressionada. |
| fmCtrlMask | 2 | CTRL foi pressionada. |
| fmAltMask | 4 | ALT foi pressionada. |
Comentários
Use esse evento para monitorar o ponteiro do mouse à medida que ele entra, sai ou descansa diretamente sobre um destino válido. Quando uma operação de arrastar e soltar está em andamento, o sistema inicia esse evento quando o usuário move o mouse ou pressiona ou libera o botão ou botões do mouse. A posição do ponteiro do mouse determina o objeto de destino que recebe esse evento. Você pode determinar o estado do ponteiro do mouse examinando o argumento DragState .
Quando um controle manipula esse evento, você pode usar o argumento Efeito para identificar a ação de arrastar e soltar a ser executada.
Quando Effect é definido como fmDropEffectCopyOrMove, a fonte de lançamento dá suporte a uma cópia (fmDropEffectCopy), move (fmDropEffectMove) ou uma operação cancelar (fmDropEffectNone).
Quando Effect é definido como fmDropEffectCopy, a fonte de lançamento dá suporte a uma operação de cópia ou cancelamento (fmDropEffectNone).
Quando Effect é definido como fmDropEffectMove, a origem suspensa dá suporte a uma operação de cancelamento (fmDropEffectNone).
Quando Effect é definido como fmDropEffectNone, a fonte de lançamento dá suporte a uma operação de cancelamento.
A maioria dos controles não dá suporte a arrastar e soltar enquanto Cancelar é False, que é a configuração padrão. Isso significa que o controle rejeita tentativas de arrastar ou soltar qualquer coisa no controle e o controle não inicia o evento BeforeDropOrPaste. Os controles TextBox e ComboBox são exceções a isso; esses controles dão suporte a operações de arrastar e soltar mesmo quando Cancelar é False.
Confira também
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.