summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2025-11-09 11:01:13 +0100
committerManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>2025-11-09 11:01:13 +0100
commitc12105193cf1f80e9ea68ddd8cb986dcd0a7d427 (patch)
tree94ac7e1635fe1a6f63dd213388d7702baa754ec8
parentfd14a3abf002766e2aa7d8a00b776cb355043edf (diff)
Complete documentation of function fl_open_callback().
-rw-r--r--README.macOS.md6
-rw-r--r--src/Fl.cxx5
2 files changed, 9 insertions, 2 deletions
diff --git a/README.macOS.md b/README.macOS.md
index 60c5441f2..7619ed056 100644
--- a/README.macOS.md
+++ b/README.macOS.md
@@ -315,8 +315,10 @@ declare several extensions.
- Call function <a href=https://www.fltk.org/doc-1.5/group__group__macosx.html#ga0702a54934d10f5b72157137cf291296>fl\_open\_callback()</a> at the beginning of your main() function to set
what function will be called when a file is dropped on the application icon.
-- In Xcode, set the "Info.plist File" build setting of your target application
-to the Info.plist file you have prepared.
+- In Xcode, set the `Info.plist File` build setting of your target application
+to the *Info.plist* file you have prepared. Alternatively, use CMake's
+`set_target_properties` function and `MACOSX_BUNDLE_INFO_PLIST` property
+to have CMake put your *Info.plist* file in the resulting macOS application bundle.
- Rebuild your application.
diff --git a/src/Fl.cxx b/src/Fl.cxx
index 818efe39d..ca0676f62 100644
--- a/src/Fl.cxx
+++ b/src/Fl.cxx
@@ -2328,6 +2328,11 @@ FL_EXPORT Window fl_xid_(const Fl_Window *w) {
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.
+
+ Use of this function also requires the application bundle's \c Info.plist file
+ to declare what file types are allowed to be dropped on the icon. File \c README.macOS.md
+ describes how to do that in its section
+ <i>Make an Application Launchable by Dropping Files on its Icon</i>.
*/
void fl_open_callback(void (*cb)(const char *))
{