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 arrastar e soltar está em andamento.
Sintaxe
Para Quadro
PrivateSubobject _BeforeDragOver( ByValCancelarComo MSForms.ReturnBoolean,
ctrlAs Control,
ByValDataAs DataObject,
ByValXAs Single,
ByValYComo Solteiro,
ByValDragStateAs fmDragState,
Efeito ByValComo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para MultiPage
Subobjeto privado _BeforeDragOver(indexAs Long,
ByValCancelar ComoMSForms.ReturnBoolean,
ctrlAs Control,
ByValDataAs DataObject,
ByValXAs Single,
ByValYComo Solteiro,
ByValDragStateAs fmDragState,
Efeito ByValComo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
para TabStrip
Subobjeto privado _BeforeDragOver(indexAs Long,
ByValCancelar ComoMSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYComo Solteiro,
ByValDragStateAs fmDragState,
Efeito ByValComo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
Para outros controles
PrivateSubobject _BeforeDragOver( ByValCancelarComo MSForms.ReturnBoolean,
ByValDataAs DataObject,
ByValXAs Single,
ByValYComo Solteiro,
ByValDragStateAs fmDragState,
Efeito ByValComo MSForms.ReturnEffect,
ByValShiftAs fmShiftState)
A sintaxe do 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 um MultiPage que a operação de arrastar e soltar afetará. |
| Cancel | Obrigatório. Status do evento. Falso indica que o controle deve manipular o evento (padrão). True indica que o aplicativo manipula o evento. |
| Ctrl | Obrigatório. O controle sendo arrastado. |
| Dados | Obrigatório. Dados que são 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 a partir da borda esquerda do controle; Y é medido a partir 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 soltar. |
| 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 alcance de um alvo. |
| fmDragStateLeave | 1 | O ponteiro do mouse está fora do alcance de um destino. |
| fmDragStateOver | 2 | O ponteiro do mouse está em uma nova posição, mas permanece dentro do alcance do mesmo alvo. |
As configurações para o efeito são:
| Constant | Valor | Descrição |
|---|---|---|
| fmDropEffectNone | 0 | Não copia nem move a origem de soltar para o destino de soltar. |
| fmDropEffectCopy | 1 | Copia a origem de soltar para o destino de soltar. |
| fmDropEffectMove | 2 | Move a origem de soltar para o destino de soltar. |
| fmDropEffectCopyOrMove | 3 | Copia ou move a origem de soltar para o destino de soltar. |
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 repousa diretamente sobre um destino válido. Quando uma operação arrastar e soltar está em andamento, o sistema inicia esse evento quando o usuário move o mouse ou pressiona ou solta 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 Effect para identificar a ação de arrastar e soltar a ser executada.
Quando Effect é definido como fmDropEffectCopyOrMove, a origem de soltar dá suporte a uma operação de cópia (fmDropEffectCopy), movimentação (fmDropEffectMove) ou cancelamento (fmDropEffectNone).
Quando Effect é definido como fmDropEffectCopy, a origem de descarte dá suporte a uma operação de cópia ou cancelamento (fmDropEffectNone).
Quando Effect é definido como fmDropEffectMove, a origem de soltar dá suporte a uma operação de movimentação ou cancelamento (fmDropEffectNone).
Quando Effect é definido como fmDropEffectNone, a origem de descarte dá suporte a uma operação de cancelamento.
A maioria dos controles não dá suporte a arrastar e soltar enquanto Cancelar é Falso, que é a configuração padrão. Isso significa que o controle rejeita as 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 é 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.