Tk Library Source Code

View Ticket
Login
Ticket UUID: 740474
Title: DropSite::register documenation error
Type: Bug Version: None
Submitter: pointsman Created on: 2003-05-20 14:08:08
Subsystem: bwidget Assigned To: hobbs
Priority: 5 Medium Severity:
Status: Closed Last Modified: 2006-11-11 04:56:08
Resolution: None Closed By: dev_null42a
    Closed on: 2006-11-10 21:56:08
Description:
The current DropSite HTML page says:

--- quotation start ---
DropSite::register  path  ?option value...?
    This command is used to declare path as a drop
site. Options are:

-dropcmd
    This command is called when user release the drag
icon over a valid drop target widget. It takes the same
arguments as -dragovercmd command. Its return values is
passed as a result to the -dragendcmd command of the
drag source widget. 
--- quotation end ---

The reference to "-dragovercmd" in the -dropcmd is
strange, because there isn't either a -dragovercmd
implemented nor documentation for it.

Probably, this is a typo and that "-dragovercmd" should
read as "-dropovercmd". But even this isn't fully
corret. It seems, the -dropcmd exptects the same args
as -dropovercmd, with the expection of the "event" arg
(which indeed would be senseless for the -dropcmd). In
other words (and as a propose for a minimum text).

Arguments passed to the command are:

    * pathname of the drop target (the widget itself),
    * pathname of the drag source,
    * root x-coordinate of the pointer,
    * root y-coordinate of the pointer,
    * operation,
    * type of the dragged data,
    * dragged data.
User Comments: dev_null42a added on 2006-11-11 04:56:08:
Logged In: YES 
user_id=1381097

Man page corrected.  Thanks.