BeforeDragOver

<< Clique para Mostrar o Sumário >>

 

BeforeDragOver

BeforeDragOver(Index, Cancel, Data, X, Y, DragState, Effect, Shift)

Ocorre quando há uma ação de arrastar e soltar (drag-and-drop) sobre um objeto. Utilize este evento para monitorar se o ponteiro do mouse entrou, deixou ou permaneceu sobre um objeto alvo. O evento é disparado quando o usuário move o ponteiro do mouse ou pressiona ou solta algum botão do mouse. A posição do ponteiro do mouse indica qual objeto gerou o evento. Pode-se determinar o status do ponteiro do mouse examinando o parâmetro DragState.

Muitos objetos não suportam operações de arrastar e soltar enquanto o parâmetro Cancel tem o valor Falso, que é o padrão. Isto significa que o objeto rejeita qualquer tentativa de arrastar ou soltar algum outro objeto sobre si e, consequentemente, não dispara o evento BeforeDropOrPaste. O objeto Text Box (Caixa de Texto) e o objeto Combo (Lista de Seleção) são exceções. Estes objetos aceitam operações de arrastar e soltar mesmo quando o parâmetro Cancel tem o valor Falso.

Parâmetros disponíveis no evento BeforeDragOver

Nome

Descrição

Index

Indica o índice da página, em um objeto multi-páginas, que é afetada pela operação que gerou o evento. Para outros objetos é ignorada

Cancel

Status do evento. O padrão é Falso e indica que é o objeto alvo que trata o evento e não a aplicação principal

Data

Dados sendo arrastados para o objeto alvo, propriamente ditos

X, Y

Posição do ponteiro do mouse dentro do objeto alvo, em pontos. X é medido a partir do lado esquerdo do objeto e Y é medido a partir do topo

DragState

Indica a condição do ponteiro do mouse quando este evento é gerado. Os valores possíveis para este parâmetro são 0 - fmDragStateEnter: O ponteiro do mouse está dentro do alcance do objeto, 1 - fmDragStateLeave: O ponteiro do mouse está fora do alcance do objeto ou 2 - fmDragStateOver: O ponteiro do mouse está em uma nova posição, mas ainda está dentro do alcance do objeto

Effect

Indica as ações que o objeto alvo suporta, ou seja, o efeito de arrastar sobre o objeto alvo. Os valores possíveis para este parâmetro são 0 - fmDropEffectNone: Objeto alvo não aceita copiar ou mover de alguma origem, 1 - fmDropEffectCopy: Objeto alvo permite copiar de alguma origem para si, 2 - fmDropEffectMove: Objeto alvo permite mover de alguma origem para si ou 3 - fmDropEffectCopyOrMove: Objeto alvo permite copiar ou mover de alguma origem para si

Shift

Inteiro cuja soma dos fatores indica o status das teclas SHIFT, CTRL e ALT. Os valores possíveis para este parâmetro são 1: Tecla SHIFT pressionada, 2: Tecla CTRL pressionada ou 4: Tecla ALT pressionada. Por exemplo, um valor igual a 5 (cinco) indica que as teclas SHIFT e ALT estavam pressionadas (1 + 4 = 5)

Esta página foi útil?