From 4593081b69c67228595a235c5a3bd7f54fab96f2 Mon Sep 17 00:00:00 2001 From: Manolo Gouy Date: Thu, 19 Oct 2017 10:15:12 +0000 Subject: Add details to the doc of fl_open_callback(). git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12517 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- src/Fl.cxx | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'src') diff --git a/src/Fl.cxx b/src/Fl.cxx index 6a3e0170b..dd1533ad8 100644 --- a/src/Fl.cxx +++ b/src/Fl.cxx @@ -2009,8 +2009,14 @@ FL_EXPORT Window fl_xid_(const Fl_Window *w) { /** Register a function called for each file dropped onto an application icon. This function is effective only on the Mac OS X platform. - \e cb will be called with a single Unix-style file name and path. - If multiple files were dropped, \e cb will be called multiple times. + \c cb will be called with a single Unix-style file name and path. + If multiple files were dropped, \c cb will be called multiple times. + + This function should be called before \c fl_open_display() is called, + either directly or indirectly (this happens at the first \c show() of a window), + to be effective for files dropped on the application icon at launch time. + It can also be called at any point to change the function used to open dropped files. + A call with a NULL argument, after a previous call, makes the app ignore files dropped later. */ void fl_open_callback(void (*cb)(const char *)) { -- cgit v1.2.3