Mercurial > hg > xemacs-beta
diff man/lispref/dragndrop.texi @ 290:c9fe270a4101 r21-0b43
Import from CVS: tag r21-0b43
author | cvs |
---|---|
date | Mon, 13 Aug 2007 10:36:47 +0200 |
parents | e11d67e05968 |
children | 70ad99077275 |
line wrap: on
line diff
--- a/man/lispref/dragndrop.texi Mon Aug 13 10:35:55 2007 +0200 +++ b/man/lispref/dragndrop.texi Mon Aug 13 10:36:47 2007 +0200 @@ -4,12 +4,12 @@ @c Original reference is (c) 1990, 1991, 1992, 1993, 1994 Free Software Foundation, Inc. @c See the file lispref.texi for copying conditions. @setfilename ../../info/dragndrop.texi -@node Drag'n'Drop, Modes, Scrollbars, Top -@chapter Drag'n'Drop -@cindex drag'n'drop +@node Drag and Drop, Modes, Scrollbars, Top +@chapter Drag and Drop +@cindex drag and drop @emph{WARNING}: the Drag'n'Drop API is still under development and the -interface may change! +interface may change! The current implementation is considered experimental. Drag'n'drop is a way to transfer information between multiple applications. To do this serveral GUIs define their own protocols. Examples are OffiX, CDE, @@ -86,7 +86,7 @@ @subsection Loose ends The following protocols will be supported soon: Xdnd, Motif, Xde (if I -get some specs). +get some specs), KDE OffiX (if KDE can find XEmacs windows). In particular Xdnd will be one of the protocols that can benefit from the XEmacs API, cause it also uses MIME types to encode dragged data. @@ -101,8 +101,20 @@ misc-user-event. This misc-user-event has its function argument set to -dragdrop-drop-dispatch and the object contains the data of the drop -(converted to URL/MIME specific data). +@code{dragdrop-drop-dispatch} and the object contains the data of the drop +(converted to URL/MIME specific data). This function will search the variable +@code{experimental-dragdrop-drop-functions} for a function that can handle the +dropped data. + +To modify the drop behaviour, the user can modify the variable +@code{experimental-dragdrop-drop-functions}. Each element of this list +specifies a possible handler for dropped data. The first one that can handle +the data will return @code{t} and exit. Another possibility is to set a +extent-property with the same name. Extents are checked prior to the +variable. + +The customization group @code{drag-n-drop} shows all variables of user +interest. @node Drag Interface @section Drag Interface