Native dialogs are platform dialogs that don't use gtk.dialog.Dialog.
They are used in order to integrate better with a platform, by
looking the same as other native applications and supporting
platform specific features.
The gtk.dialog.Dialog functions cannot be used on such objects,
but we need a similar API in order to drive them. The gtk.native_dialog.NativeDialog
object is an API that allows you to do this. It allows you to set
various common properties on the dialog, as well as show and hide
it and get a gtk.native_dialog.NativeDialog.response signal when the user
finished with the dialog.
Note that unlike gtk.dialog.Dialog, gtk.native_dialog.NativeDialog 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.
Native dialogs are platform dialogs that don't use gtk.dialog.Dialog.
They are used in order to integrate better with a platform, by looking the same as other native applications and supporting platform specific features.
The gtk.dialog.Dialog functions cannot be used on such objects, but we need a similar API in order to drive them. The gtk.native_dialog.NativeDialog object is an API that allows you to do this. It allows you to set various common properties on the dialog, as well as show and hide it and get a gtk.native_dialog.NativeDialog.response signal when the user finished with the dialog.
Note that unlike gtk.dialog.Dialog, gtk.native_dialog.NativeDialog 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.