[gtk+] GtkFileChooserNative: documentation updated
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] GtkFileChooserNative: documentation updated
- Date: Tue, 18 Jul 2017 17:36:22 +0000 (UTC)
commit 946166e08000c3f1d5da44b5702461a83db18fbb
Author: Tom Schoonjans <Tom Schoonjans diamond ac uk>
Date: Sun Jul 9 18:04:06 2017 +0100
GtkFileChooserNative: documentation updated
https://bugzilla.gnome.org/show_bug.cgi?id=784723
gtk/gtkfilechoosernative.c | 20 ++++++++++++++++++--
1 files changed, 18 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c
index 5998947..acf4ed7 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 {
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]