GtkApplication Docs: Add a hint.

gtk_application_set_app_menu(), gtk_application_set_menubar():
Mention that you probably want to call this in the startup signal
handler. If you do it earlier you will likely get a warning about
a missing D-Bus connection, because doing it earlier does not
make sense anyway.
This commit is contained in:
Murray Cumming 2012-03-28 11:26:22 +02:00
parent f900ae4aaa
commit c00cfda370

View File

@ -784,8 +784,8 @@ gtk_application_class_init (GtkApplicationClass *class)
* as soon as the application gets registered as the primary instance. * as soon as the application gets registered as the primary instance.
* *
* Concretely, gtk_init() is called in the default handler for the * Concretely, gtk_init() is called in the default handler for the
* startup() signal. Therefore, #GtkApplication subclasses should * #GApplication:startup signal. Therefore, #GtkApplication subclasses should
* chain up in their startup() handler before using any GTK+ API. * chain up in their #GApplication:startup handler before using any GTK+ API.
* *
* Note that commandline arguments are not passed to gtk_init(). * Note that commandline arguments are not passed to gtk_init().
* All GTK+ functionality that is available via commandline arguments * All GTK+ functionality that is available via commandline arguments
@ -1008,6 +1008,8 @@ gtk_application_remove_accelerator (GtkApplication *application,
* If supported, the application menu will be rendered by the desktop * If supported, the application menu will be rendered by the desktop
* environment. * environment.
* *
* You might call this method in your #GApplication:startup signal handler.
*
* Use the base #GActionMap interface to add actions, to respond to the user * Use the base #GActionMap interface to add actions, to respond to the user
* selecting these menu items. * selecting these menu items.
* *
@ -1075,6 +1077,8 @@ gtk_application_get_app_menu (GtkApplication *application)
* example, the application menu may be rendered by the desktop shell * example, the application menu may be rendered by the desktop shell
* while the menubar (if set) remains in each individual window. * while the menubar (if set) remains in each individual window.
* *
* You might call this method in your #GApplication:startup signal handler.
*
* Use the base #GActionMap interface to add actions, to respond to the user * Use the base #GActionMap interface to add actions, to respond to the user
* selecting these menu items. * selecting these menu items.
* *