On Begin Drag Over

Code	Pode ser chamado por	Definição
17	4D Write Pro area - Button - Button Grid - Check Box - Dropdown list - Form - Hierarchical List - Input - List Box - List Box Column - Picture Button - Picture Pop up menu - Plug-in Area - Progress Indicators - Radio Button - Ruler - Spinner - Splitter - Stepper - Tab control	Um objecto está a ser arrastado

Descrição

El evento de formulario On Begin Drag Over puede ser seleccionado para todos los objetos formulario que puedan ser arrastrados. Se genera en todos los casos en que el objeto tiene la propiedad 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.

Unlike the On Drag Over form event, On Begin Drag Over is called within the context of the source object of the drag action.

El evento On Begin Drag Over es útil para preparar la acción de arrastrar. Pode ser usado para:

• Añadir los datos y las firmas al portapapeles (vía el comando APPEND DATA TO PASTEBOARD).
• Utilizar un icono personalizado durante la acción de arrastre (vía el comando SET DRAG ICON).
• Aceitar ou recusar o arrastamento através de $0 no método do objeto arrastado.
  • Para indicar que se aceptan las acciones de arrastre, el método del objeto fuente debe devolver 0 (cero); por tanto, debe ejecutar $0:=0.
  • Para indicar que se rechazan las acciones de arrastre, el método del objeto fuente debe devolver -1 (menos uno); por tanto, debe ejecutar $0:=-1.
  • Se nenhum resultado for retornado, 4D considera que as ações de arrastar são aceitas.

Os dados 4D são colocados na prancheta antes de chamar o evento. Por ejemplo, en el caso de arrastrar sin la acción Arrastre automático, el texto arrastrado ya está en portapapeles cuando se llama al evento.