company logo

GUIBaseContext :: doBeforeDrop - Pre-event handler for Drop events

The pre-event handler for drop events ( GEV_BeginDrop ) is called before the drop action will be executed. The handler may access information in the drop object using functions as dropText() or dropProperty() . propPosition() and GetHorizontalDropPosition () will return the position where the object is going to be dropped. The handler allows canceling the drop action by returning 1 .

The handler should return one of the following values:

  • -1 (not handled) - the event handler will be removed from the handler list and is not called anymore.
  • 1 (refuse) - Requested action will not be executed.
  • 0 (ok) - Action is permitted to be executed.

Implementation details

int32 GUIBaseContext  :: doBeforeDrop (  )