On Begin Drag Over
| Code | Pode ser chamado por | Definição |
|---|---|---|
| 17 | Área 4D Write Pro - Botão - Grelha de botões - Caixa de seleção - Lista suspensa - Formulário - Lista hierárquica - Área de entrada -List Box - Coluna de List Box - Botão imagem - Imagen del menú emergente - Área de plug-in - Indicador de progresso - Botão de raio - Regua -Spinner - Splitter - Stepper - Tab | Um objecto está a ser arrastado |
Descrição
O evento de formulário On Begin Drag Over pode ser seleccionado para quaisquer objectos de formulário que possam ser arrastados. Ela é gerada em todos os casos em que o objeto tem a propriedade Draggable . Ele pode ser chamado a partir do método do objeto de origem ou do método de formulário do objeto de origem.
Ao contrário do evento de formulário
On Drag Over, o eventoOn Begin Drag Overé chamado no contexto do objeto de origem **** da ação de arrastar.
O evento On Begin Drag Over é útil para preparar a ação de arrastar. Pode ser usado para:
- Adicione dados e assinaturas ao pasteboard (por meio do comando
APPEND DATA TO PASTEBOARD). - Use um ícone personalizado durante a ação de arrastar (por meio do comando
SET DRAG ICON). - Aceitar ou recusar o arrastamento através de $0 no método do objeto arrastado.
- Para indicar que as ações de arrastar são aceitas, o método do objeto de origem deve retornar 0 (zero); portanto, você deve executar
$0:=0. - Para indicar que as ações de arrastar são recusadas, o método do objeto de origem deve retornar -1 (menos um); portanto, você deve executar
$0:=-1. - Se nenhum resultado for retornado, 4D considera que as ações de arrastar são aceitas.
- Para indicar que as ações de arrastar são aceitas, o método do objeto de origem deve retornar 0 (zero); portanto, você deve executar
Os dados 4D são colocados na prancheta antes de chamar o evento. Por exemplo, no caso de arrastar sem a ação Arrastar Automático , o texto arrastado já está no quadro quando o evento é chamado.