On Drag Over
| Code | Pode ser chamado por | Definição |
|---|---|---|
| 21 | 4D Write Pro area - Button - Button Grid - Check Box - [Lista Dropdown](FormObjects/dropdownList_Overview. d) - Lista Hierárquica - Input - Caixa de Lista - [Coluna de caixa de lista](FormObjects/listbox_overview. d#list-box-columns) - Botão de imagens - Menu de imagens pop-up - Área de Plug-in - [Indicadores de progresso](FormObjects/progressIndicador. d) - Botão de Rádio - Ruler - Spinner - Splitter - Stepper - Controle de tabulação | Os dados podem ser largados sobre um objeto |
Descrição
O evento Ao Arrastar Para é repetidamente enviado para o objeto de destino quando o ponteiro do mouse é movido sobre o objeto. Em resposta a este evento, normalmente:
- Obtenha os dados e assinaturas encontrados no pasteboard (via o comando
GET PASTEBOARD DATA). - Dependendo da natureza e do tipo de dados na área de transferência, você aceita ou rejeita o arrastar e soltar.
Para aceitar o arrasto, o método do objeto de destino deve retornar 0 (zero), então você escreve $0:=0.
Para rejeitar o arrasto, o método do objeto deve retornar -1 (menos um), então você escreve $0:=-1.
Durante um evento Ao Arrastar Exterior, o 4D trata o método do objeto como uma função. Se nenhum resultado for devolvido, 4D assume que o arrasto é aceite.
Se aceitar o arrastamento, o objeto de destino é realçado. Se rejeitar o arrastamento, o destino não é realçado. Aceitar a ação de arrastar não significa que os dados arrastados serão inseridos no objeto de destino. Isso significa apenas que se o botão do mouse for solto neste ponto, o objeto de destino aceitaria os dados arrastados e o evento On Drop seria disparado.
Se você não processar o evento On Drag Over para um objeto soltável, esse objeto será destacado para todas as operações de arrastar, não importa qual seja a natureza e o tipo dos dados arrastados.
O evento On Drag Over é a maneira pela qual você controla a primeira fase de uma operação de arrastar e soltar. Você não apenas pode testar se os dados arrastados são de um tipo compatível com o objeto de destino e então aceitar ou rejeitar o arrasto; mas também pode notificar simultaneamente o usuário deste fato, pois o 4D ressalta (ou não) o objeto de destino com base na sua decisão.
O código que manipula um evento 'On Drag Over' deve ser curto e executar rapidamente, porque esse evento é enviado repetidamente para o objeto de destino atual, devido aos movimentos do mouse.