#include <gnome.h> struct GnomeApp; |
|
Toplevel GNOME applications would normally use one GnomeApp widget as their toplevel window. You can create as many GnomeApp widgets as you want, for example, some people use one GnomeApp per document their application loads.
Once you have created one instance of this widget, you would add your main application view information to this window by using gnome_app_set_contents() routine.
The GnomeApp has support for including a menubar one or more toolbars and a statusbar for your application, it also takes care of intalling the accelerators for you when used in conjuction with the gnome-app-helper routines. The toolbars are inserted into GnomeDock widgets.
The gnome-app-helper module provides various helper routines to simplify the configuration of your menus and toolbars, but you can create those yourself and use the gnome_app_set_menus(), gnome_app_add_toolbar(), gnome_app_set_toolbar(), gnome_app_add_dock_item(), and gnome_app_add_docked().
|
Create a new (empty) application window. You must specify the application's name (used internally as an identifier). title can be left as NULL, in which case the window's title will not be set.
void gnome_app_construct (GnomeApp *app, |
Constructor for language bindings; you don't normally need this.
void gnome_app_set_menus (GnomeApp *app, |
Sets the menu bar of the application window.
void gnome_app_set_toolbar (GnomeApp *app, |
Sets the main toolbar of the application window.
void gnome_app_set_statusbar (GnomeApp *app, |
Sets the status bar of the application window.
void gnome_app_set_contents (GnomeApp *app, |
Sets the content area of the GNOME app's main window.
void gnome_app_add_toolbar (GnomeApp *app, |
Create a new &GnomeDockItem widget containing toolbar, and add it to app's dock with the specified layout information. Notice that, if automatic layout configuration is enabled, the layout is overridden by the saved configuration, if any.
void gnome_app_add_docked (GnomeApp *app, |
Add widget as a dock item according to the specified layout information. Notice that, if automatic layout configuration is enabled, the layout is overridden by the saved configuration, if any.
void gnome_app_add_dock_item (GnomeApp *app, GnomeDockItem *item, GnomeDockPlacement placement, |
void gnome_app_enable_layout_config (GnomeApp *app, |
Specify whether app should automatically save the dock's layout configuration via gnome-config whenever it changes or not.
GnomeDock* gnome_app_get_dock (GnomeApp *app); |
Retrieves the &GnomeDock widget contained in the &GnomeApp.
GnomeDockItem* gnome_app_get_dock_item_by_name (GnomeApp *app, const |
Retrieve the dock item whose name matches name.