Documentation additions

This commit is contained in:
Matthias Clasen 2011-12-07 23:55:33 -05:00 committed by Ryan Lortie
parent 0baa663182
commit f485dd3f08
2 changed files with 19 additions and 6 deletions

View File

@ -608,6 +608,11 @@ gtk_application_get_windows (GtkApplication *application)
* are referred to with an "app." prefix, and window-specific actions
* with a "win." prefix.
*
* GtkApplication also extracts accelerators out of 'accel' attributes
* in the #GMenuModels passed to g_application_set_app_menu() and
* g_application_set_menubar(), which is usually more convenient
* than calling this function for each accelerator.
*
* Since: 3.4
*/
void

View File

@ -37,7 +37,7 @@
* GtkApplicationWindow is a #GtkWindow subclass that offers some
* extra functionality for better integration with #GtkApplication
* features. Notably, it can handle both the application menu as well
* as the menubar. See g_application_set_app_menu() and
* as the menubar. See g_application_set_app_menu() and
* g_application_set_menubar().
*
* This class implements the #GActionGroup and #GActionMap interfaces,
@ -48,11 +48,19 @@
* prefix. Actions must be addressed with the prefixed name when
* referring to them from a #GMenuModel.
*
* If the desktop environment does not display the application menu
* as part of the desktop shell, then #GApplicationWindow will
* automatically show the menu as part of a menubar. This behaviour
* can be overridden with the #GtkApplicationWindow:show-menubar
* property.
* 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
* models outside the application as part of the desktop shell.
* For instance, on OS X, both menus will be displayed remotely;
* on Windows neither will be. gnome-shell (starting with version 3.4)
* will display the application menu, but not the menubar.
*
* If the desktop environment does not display the menubar, then
* #GApplicationWindow will automatically show a #GtkMenubar for it.
* This behaviour can be overridden with the #GtkApplicationWindow:show-menubar
* property. If the desktop environment does not display the application
* menu, then it will automatilly be included in the menubar.
*
* <example><title>A GtkApplicationWindow with a menubar</title>
* <programlisting><![CDATA[