Skip to main content

Module dialogs

Module dialogs 

Source
Expand description

Open, save and folder pickers (rfd).

Describe the dialog with FileDialog, then call a blocking picker (FileDialog::open_file, …) or its async twin (FileDialog::open_file_async, …). A dismissed dialog is NativeError::Cancelled.

Threads: on macOS the blocking pickers must run on the main thread (or on another thread while the main thread is running its event loop); the async pickers run anywhere and are the right choice inside an event loop. On the web only FileDialog::open_bytes_async exists (browsers give the page a file’s contents, never its path); everything else is Unsupported.

message shows a modal message box, for what must be said before (or without) a window: a start-up failure, command-line output in an app that has no console.

Structs§

FileDialog
What a dialog shows. Every field is optional.
Filter
One filter row: a name and the extensions it accepts (without dots: ["png", "jpg"]).

Enums§

MessageLevel
How serious a message is; the OS picks the icon.

Functions§

message
Show a modal message box with one OK button and wait until it is dismissed. Main thread on macOS. Unsupported on the web.