Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Ocorre quando uma operação de arrastar e largar está em curso.
Sintaxe
Para Frame
Private Subobject _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ctrlComo Controlo,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo único,
ByValDragStateComo fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para Várias Páginas
Objeto Sub Privado_BeforeDragOver(índiceTão Longo,
ByValCancelAs MSForms.ReturnBoolean,
ctrlComo Controlo,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo único,
ByValDragStateComo fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para TabStrip
Objeto Sub Privado_BeforeDragOver(índiceTão Longo,
ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo único,
ByValDragStateComo fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para outros controles
Private Subobject _BeforeDragOver( ByValCancelAs MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXComo Único,
ByValYcomo único,
ByValDragStateComo fmDragState,
ByValEffectAs MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
A sintaxe do evento BeforeDragOver tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Um nome de objeto válido. |
| índice | Obrigatório. O índice da Página numa Página Múltipla que a operação de arrastar e largar irá afetar. |
| Cancel | Obrigatório. Status de eventos. Falso indica que o controlo deve processar o evento (predefinição). True indica que a aplicação processa o evento. |
| ctrl | Obrigatório. O controlo a ser arrastado. |
| Dados | Obrigatório. Dados que são arrastados numa operação de arrastar e largar. Os dados são empacotados num DataObject. |
| X, Y | Obrigatório. As coordenadas horizontais e verticais da posição do controlo. Ambas as coordenadas são medidas em pontos. X é medido a partir da margem esquerda do controlo; Y é medido a partir da parte superior do controlo.. |
| DragState | Obrigatório. Estado de transição dos dados que estão a ser arrastados. |
| Effect | Obrigatório. Operações suportadas pela origem de remoção. |
| Shift | Obrigatório. Especifica o estado de SHIFT, CTRL e ALT. |
Configurações
As definições de DragState são:
| Constant | Valor | Descrição |
|---|---|---|
| fmDragStateEnter | 0 | O ponteiro do rato está dentro do alcance de um destino. |
| fmDragStateLeave | 1 | O ponteiro do rato está fora do intervalo de um destino. |
| fmDragStateOver | 2 | O ponteiro do rato encontra-se numa nova posição, mas permanece dentro do alcance do mesmo destino. |
As definições para Efeito são:
| Constant | Valor | Descrição |
|---|---|---|
| fmDropEffectNone | 0 | Não copia nem move a origem de remoção para o destino de remoção. |
| fmDropEffectCopy | 1 | Copia a origem de remoção para o destino de remoção. |
| fmDropEffectMove | 2 | Move a origem de remoção para o destino de remoção. |
| fmDropEffectCopyOrMove | 3 | Copia ou move a origem de remoção para o destino de remoção. |
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
Utilize este evento para monitorizar o ponteiro do rato à medida que entra, sai ou descansa diretamente sobre um destino válido. Quando uma operação de arrastar e largar está em curso, o sistema inicia este evento quando o utilizador move o rato ou prime ou solta o botão ou botões do rato. A posição do ponteiro do rato determina o objeto de destino que recebe este evento. Pode determinar o estado do ponteiro do rato ao examinar o argumento DragState .
Quando um controlo processa este evento, pode utilizar o argumento Efeito para identificar a ação de arrastar e largar a executar.
Quando o Efeito está definido como fmDropEffectCopyOrMove, a origem de remoção suporta uma cópia (fmDropEffectCopy), movimentação (fmDropEffectMove) ou uma operação de cancelamento (fmDropEffectNone).
Quando o Efeito está definido como fmDropEffectCopy, a origem de remoção suporta uma operação de cópia ou cancelamento (fmDropEffectNone).
Quando o Efeito está definido como fmDropEffectMove, a origem de remoção suporta uma operação de movimentação ou cancelamento (fmDropEffectNone).
Quando o Efeito está definido como fmDropEffectNone, a origem de remoção suporta uma operação de cancelamento.
A maioria dos controlos não suporta arrastar e largar enquanto Cancelar é Falso, que é a predefinição. Isto significa que o controlo rejeita tentativas de arrastar ou largar qualquer coisa no controlo e o controlo não inicia o evento BeforeDropOrPaste. Os controlos Caixa de Texto e Caixa de Combinação são exceções; estes controlos suportam operações de arrastar e largar mesmo quando Cancelar é Falso.
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.