summaryrefslogtreecommitdiff
path: root/gtk/gtkfilechoosernative.c
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-01-31 20:22:59 -0500
committerMatthias Clasen <mclasen@redhat.com>2021-01-31 20:25:44 -0500
commit7985d277b3c58156ba619dc28ee90d08ad892cac (patch)
tree4ea8ad1d6642322468662ff6d874081cc694ac14 /gtk/gtkfilechoosernative.c
parent752da5c2a547d3ea93a7b3f23a33e66f50a330f9 (diff)
downloadgtk+-7985d277b3c58156ba619dc28ee90d08ad892cac.tar.gz
nativedialog: Add more docs
Emphasize that native dialogs aren't widgets, and are not kept alive by GTK.
Diffstat (limited to 'gtk/gtkfilechoosernative.c')
-rw-r--r--gtk/gtkfilechoosernative.c5
1 files changed, 5 insertions, 0 deletions
diff --git a/gtk/gtkfilechoosernative.c b/gtk/gtkfilechoosernative.c
index 597deb5256..067d2b19f6 100644
--- a/gtk/gtkfilechoosernative.c
+++ b/gtk/gtkfilechoosernative.c
@@ -60,6 +60,11 @@
* Showing, hiding and running the dialog is handled by the #GtkNativeDialog
* functions.
*
+ * Note that unlike #GtkFileChooserDialog, #GtkFileChooserNative objects are
+ * not toplevel widgets, and GTK does not keep them alive. It is your
+ * responsibility to keep a reference until you are done with the
+ * object.
+
* ## Typical usage ## {#gtkfilechoosernative-typical-usage}
*
* In the simplest of cases, you can the following code to use