diff options
| author | Tom Schoonjans <Tom.Schoonjans@diamond.ac.uk> | 2017-07-09 18:04:06 +0100 |
|---|---|---|
| committer | Matthias Clasen <mclasen@redhat.com> | 2017-07-18 13:30:44 -0400 |
| commit | 946166e08000c3f1d5da44b5702461a83db18fbb (patch) | |
| tree | c34709841cd00a49da05c510cb6acdc7802cdb2b /gtk/gtkfilechoosernative.c | |
| parent | a4775f8e924b5672b1698fea5441e949a7b70afa (diff) | |
| download | gtk+-946166e08000c3f1d5da44b5702461a83db18fbb.tar.gz | |
GtkFileChooserNative: documentation updated
https://bugzilla.gnome.org/show_bug.cgi?id=784723
Diffstat (limited to 'gtk/gtkfilechoosernative.c')
| -rw-r--r-- | gtk/gtkfilechoosernative.c | 20 |
1 files changed, 18 insertions, 2 deletions
diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c index 5998947880..acf4ed7006 100644 --- a/gtk/gtkfilechoosernative.c +++ b/gtk/gtkfilechoosernative.c @@ -50,8 +50,8 @@ * #GtkFileChooserNative is an abstraction of a dialog box suitable * for use with “File/Open” or “File/Save as” commands. By default, this * just uses a #GtkFileChooserDialog to implement the actual dialog. - * However, on certain platforms, such as Windows, the native platform - * file chooser is uses instead. When the application is running in a + * However, on certain platforms, such as Windows and macOS, the native platform + * file chooser is used instead. When the application is running in a * sandboxed environment without direct filesystem access (such as Flatpak), * #GtkFileChooserNative may call the proper APIs (portals) to let the user * choose a file and make it available to the application. @@ -187,6 +187,22 @@ * * Use of custom previews by connecting to #GtkFileChooser::update-preview. * * * Any #GtkFileFilter added with a custom filter. + * + * ## macOS details ## {#gtkfilechooserdialognative-macos} + * + * On macOS the NSSavePanel and NSOpenPanel classes are used to provide native + * file chooser dialogs. Some features provided by #GtkFileChooserDialog are + * not supported: + * + * * Extra widgets added with gtk_file_chooser_set_extra_widget(), unless the + * widget is an instance of GtkLabel, in which case the label text will be used + * to set the NSSavePanel message instance property. + * + * * Use of custom previews by connecting to #GtkFileChooser::update-preview. + * + * * Any #GtkFileFilter added with a custom filter. + * + * * Shortcut folders. */ enum { |