<!-- ##### 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: