Package: gtk

Class gtk:native-dialog

Superclasses

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

Documented Subclasses

Direct Slots

modal
The modal property of type :boolean (Read / Write)
Whether the dialog window should be modal with respect to its transient parent.
title
The title property of type :string (Read / Write)
The title of the dialog window.
transient-for
The transient-for property of type gtk:window (Read / Write / Construct)
The transient parent of the dialog window, or nil for none.
visible
The visible property of type :boolean (Read / Write)
Whether the dialog window is currenlty visible.

Details

Native dialogs are platform dialogs that do not use gtk:dialog or gtk:window widgets. 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.

There is also a gtk:native-dialog-run helper function that makes it easy to run any native dialog in a modal way with a recursive main loop, similar to the gtk:dialog-run function.

Signal Details

The "response" signal
lambda (dialog id)    :run-last      
Emitted when the user responds to the dialog window. When this is called the dialog window has been hidden. If you call the gtk:native-dialog-hide function before the user responds to the dialog window this signal will not be emitted.
dialog
The gtk:native-dialog widget which received the signal.
id
An integer with the response ID.
 

Slot Access Functions

Inherited Slot Access Functions

See also

#2023-6-10