|
<< 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) |