<!-- ##### SECTION Title ##### --> GnomeApp <!-- ##### SECTION Short_Description ##### --> The toplevel GNOME container <!-- ##### SECTION Long_Description ##### --> <para>Toplevel GNOME applications would normally use one <type>GnomeApp</type> widget as their toplevel window. You can create as many <type>GnomeApp</type> widgets as you want, for example, some people use one GnomeApp per document their application loads.</para> <para>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.</para> <para> The <type>GnomeApp</type> 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 <type>GnomeDock</type> widgets.</para> <para>The <filename>gnome-app-helper</filename> 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().</para> <!-- ##### SECTION See_Also ##### --> <para> </para> <!-- ##### STRUCT GnomeApp ##### --> <para> </para> <!-- ##### FUNCTION gnome_app_new ##### --> <para> </para> @appname: @title: @Returns: <!-- ##### FUNCTION gnome_app_construct ##### --> <para> </para> @app: @appname: @title: <!-- ##### MACRO GNOME_APP_MENUBAR_NAME ##### --> <para> </para> <!-- ##### MACRO GNOME_APP_TOOLBAR_NAME ##### --> <para> </para> <!-- ##### FUNCTION gnome_app_set_menus ##### --> <para> </para> @app: @menubar: <!-- ##### FUNCTION gnome_app_set_toolbar ##### --> <para> </para> @app: @toolbar: <!-- ##### FUNCTION gnome_app_set_statusbar ##### --> <para> </para> @app: @statusbar: <!-- ##### FUNCTION gnome_app_set_contents ##### --> <para> </para> @app: @contents: <!-- ##### FUNCTION gnome_app_add_toolbar ##### --> <para> </para> @app: @toolbar: @name: @behavior: @placement: @band_num: @band_position: @offset: <!-- ##### FUNCTION gnome_app_add_docked ##### --> <para> </para> @app: @widget: @name: @behavior: @placement: @band_num: @band_position: @offset: <!-- ##### FUNCTION gnome_app_add_dock_item ##### --> <para> </para> @app: @item: @placement: @band_num: @band_position: @offset: <!-- ##### FUNCTION gnome_app_enable_layout_config ##### --> <para> </para> @app: @enable: <!-- ##### FUNCTION gnome_app_get_dock ##### --> <para> </para> @app: @Returns: <!-- ##### FUNCTION gnome_app_get_dock_item_by_name ##### --> <para> </para> @app: @name: @Returns: