- NAME
- DragSite - Commands set for Drag facilities
- COMMAND
- DragSite::include class type event
- DragSite::register path ?option value...?
- DragSite::setdrag path subpath initcmd endcmd ?force?
DESCRIPTION
Commands of this namespace enable user to define a BWidget or a Tk widget as a drag site.
COMMAND
- DragSite::include class type event
- This command provides a simple way to include options relatives
to a drag site into BWidget resources definition. It includes the
options needed for register: -dragevent, initialized
to event, -draginitcmd and -dragendcmd,
initialized to empty string, and two new options:
-dragenabled Specifies wether or not drag is active (initialized to 0) -dragtype Default or alternate dragged data type (initialized to type)
- DragSite::register path ?option value...?
- This command is used to declare path as a drag site.
Options are:
- -dragendcmd
- Command called when drag terminates (ie when user release drag
icon). This command is called with the following arguments:
- the pathname of the drag source (the widget itself),
- the pathname of the drop target,
- the operation,
- the type of the dragged data,
- the dragged data,
- result of the drop (result of the call to -dropcmd of the target),
- -dragevent
- Specifies the number of the mouse button associated to the drag. Must be 1, 2 or 3.
- -draginitcmd
- Command called when drag initiates. When the event of option
dragevent occurs on path, this command is called with
the following arguments:
- pathname of the drag source (path),
- root x-coordinate of pointer,
- root y-coordinate of pointer,
- a toplevel created to represent dragged data. When returning, if it has no children, a bitmap is automatically displayed.
- the type of the data,
- the list of acceptable basic operations (copy, move and link)
- and the data.
- DragSite::setdrag path subpath initcmd endcmd ?force?
- This command provides a simple way to call register
during a BWidget creation or configuration.
- path is the pathname of the BWidget,
- subpath is the pathname of the tk widget where drag event occurs,
- initcmd BWidget command for drag-init event,
- endcmd BWidget command for drag-end event,
- force specifies wether or not to call register whenever no option value has changed (0 by default - for BWidget configuration, use 1 for BWidget creation).