mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2025-01-15 14:50:06 +00:00
GtkApplication: document relationship to gdkthreads
This commit is contained in:
parent
6a246a85f2
commit
06c8921975
@ -62,6 +62,15 @@
|
||||
* While GtkApplication works fine with plain #GtkWindows, it is recommended
|
||||
* to use it together with #GtkApplicationWindow.
|
||||
*
|
||||
* When GDK threads are enabled, GtkApplication will acquire the GDK
|
||||
* lock when invoking actions that arrive from other processes. The GDK
|
||||
* lock is not touched for local action invocations. In order to have
|
||||
* actions invoked in a predictable context it is therefore recommended
|
||||
* that the GDK lock be held while invoking actions locally with
|
||||
* g_action_group_activate_action(). The same applies to actions
|
||||
* associated with #GtkApplicationWindow and to the 'activate' and
|
||||
* 'open' #GApplication methods.
|
||||
*
|
||||
* To set an application menu on a GtkApplication, use
|
||||
* g_application_set_app_menu(). The #GMenuModel that this function
|
||||
* expects is usually constructed using #GtkBuilder, as seen in the
|
||||
|
@ -54,6 +54,10 @@
|
||||
* prefix. Actions must be addressed with the prefixed name when
|
||||
* referring to them from a #GMenuModel.
|
||||
*
|
||||
* As with #GtkApplication, the GDK lock will be acquired when
|
||||
* processing actions arriving from other processes and should therefore
|
||||
* be held when activating actions locally (if GDK threads are enabled).
|
||||
*
|
||||
* The settings #GtkSettings:gtk-shell-shows-app-menu and
|
||||
* #GtkSettings:gtk-shell-shows-menubar tell GTK+ whether the
|
||||
* desktop environment is showing the application menu and menubar
|
||||
|
Loading…
Reference in New Issue
Block a user