Complete documentation of function fl_open_callback().

This commit is contained in:
ManoloFLTK 2025-11-09 11:01:13 +01:00
parent fd14a3abf0
commit c12105193c
2 changed files with 9 additions and 2 deletions

View File

@ -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.

View File

@ -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 *))
{