Class native-dialog - cl-cffi-gtk4 API documentation

Package: gtk

Class gtk:native-dialog

Superclasses

gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

gtk:file-chooser-native

Direct Slots

The modal property of type :boolean (Read / Write)
Whether the window should be modal with respect to its transient parent.
Default value: false

title

The title property of type :string (Read / Write)
The title of the dialog window.
Default value: nil

transient-for

The transient-for property of type gtk:window (Read / Write / Construct)
The transient parent of the dialog, or nil for none.

visible

The visible property of type :boolean (Read / Write)
Whether the window is currently visible.
Default value: false

Details

Native dialogs are platform dialogs that do not use the gtk:dialog or gtk:window classes. 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 functions cannot be used on such objects, but we need a similar API in order to drive them. The gtk:native-dialog 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 "response" signal when the user finished with the dialog.

Signal Details

The "response" signal

lambda (dialog response)    :run-last

dialog: The gtk:native-dialog object on which the signal is emitted.
response: The integer with the response ID.

Emitted when the user responds to the dialog. When this is called the dialog has been hidden. If you call the gtk:native-dialog-hide function before the user responds to the dialog this signal will not be emitted.