<refentry id="GnomeMDIChild">
<refmeta>
<refentrytitle role="top_of_page" id="GnomeMDIChild.top_of_page">GnomeMDIChild</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>LIBGNOMEUI Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeMDIChild</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="GnomeMDIChild.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;libgnomeui/libgnomeui.h&gt;

<link linkend="GtkWidget">GtkWidget</link> *         (<link linkend="GnomeMDIChildViewCreator">*GnomeMDIChildViewCreator</link>)         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="gpointer">gpointer</link> );
<link linkend="GList">GList</link> *             (<link linkend="GnomeMDIChildMenuCreator">*GnomeMDIChildMenuCreator</link>)         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="GtkWidget">GtkWidget</link> *,
                                                         <link linkend="gpointer">gpointer</link> );
<link linkend="gchar">gchar</link> *             (<link linkend="GnomeMDIChildConfigFunc">*GnomeMDIChildConfigFunc</link>)          (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="gpointer">gpointer</link> );
<link linkend="GtkWidget">GtkWidget</link> *         (<link linkend="GnomeMDIChildLabelFunc">*GnomeMDIChildLabelFunc</link>)           (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="GtkWidget">GtkWidget</link> *,
                                                         <link linkend="gpointer">gpointer</link> );
                    <link linkend="GnomeMDIChild-struct">GnomeMDIChild</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gnome-mdi-child-add-view">gnome_mdi_child_add_view</link>            (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child);
<link linkend="void">void</link>                <link linkend="gnome-mdi-child-remove-view">gnome_mdi_child_remove_view</link>         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         <link linkend="GtkWidget">GtkWidget</link> *view);
<link linkend="void">void</link>                <link linkend="gnome-mdi-child-set-name">gnome_mdi_child_set_name</link>            (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         const <link linkend="gchar">gchar</link> *name);
<link linkend="void">void</link>                <link linkend="gnome-mdi-child-set-menu-template">gnome_mdi_child_set_menu_template</link>   (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         <link linkend="GnomeUIInfo">GnomeUIInfo</link> *menu_tmpl);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GnomeMDIChild.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----GnomeMDIChild
                     +----<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link>
</synopsis>
</refsect1>








<refsect1 id="GnomeMDIChild.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="GnomeMDIChild.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeMDIChildViewCreator" role="function" condition="deprecated:">
<title>GnomeMDIChildViewCreator ()</title>
<indexterm zone="GnomeMDIChildViewCreator" role="deprecated"><primary sortas="GnomeMDIChildViewCreator">GnomeMDIChildViewCreator</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         (*GnomeMDIChildViewCreator)         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="gpointer">gpointer</link> );</programlisting>
<warning><para><literal>GnomeMDIChildViewCreator</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>Param1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GnomeMDIChildMenuCreator" role="function" condition="deprecated:">
<title>GnomeMDIChildMenuCreator ()</title>
<indexterm zone="GnomeMDIChildMenuCreator" role="deprecated"><primary sortas="GnomeMDIChildMenuCreator">GnomeMDIChildMenuCreator</primary></indexterm><programlisting><link linkend="GList">GList</link> *             (*GnomeMDIChildMenuCreator)         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="GtkWidget">GtkWidget</link> *,
                                                         <link linkend="gpointer">gpointer</link> );</programlisting>
<warning><para><literal>GnomeMDIChildMenuCreator</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>Param1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param3</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GnomeMDIChildConfigFunc" role="function" condition="deprecated:">
<title>GnomeMDIChildConfigFunc ()</title>
<indexterm zone="GnomeMDIChildConfigFunc" role="deprecated"><primary sortas="GnomeMDIChildConfigFunc">GnomeMDIChildConfigFunc</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             (*GnomeMDIChildConfigFunc)          (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="gpointer">gpointer</link> );</programlisting>
<warning><para><literal>GnomeMDIChildConfigFunc</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>Param1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GnomeMDIChildLabelFunc" role="function" condition="deprecated:">
<title>GnomeMDIChildLabelFunc ()</title>
<indexterm zone="GnomeMDIChildLabelFunc" role="deprecated"><primary sortas="GnomeMDIChildLabelFunc">GnomeMDIChildLabelFunc</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         (*GnomeMDIChildLabelFunc)           (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *,
                                                         <link linkend="GtkWidget">GtkWidget</link> *,
                                                         <link linkend="gpointer">gpointer</link> );</programlisting>
<warning><para><literal>GnomeMDIChildLabelFunc</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>Param1</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param2</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>Param3</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="GnomeMDIChild-struct" role="struct">
<title>GnomeMDIChild</title>
<indexterm zone="GnomeMDIChild-struct" role="deprecated"><primary sortas="GnomeMDIChild">GnomeMDIChild</primary></indexterm><programlisting>typedef struct _GnomeMDIChild GnomeMDIChild;</programlisting>
<warning><para><literal>GnomeMDIChild</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para></refsect2>
<refsect2 id="gnome-mdi-child-add-view" role="function" condition="deprecated:">
<title>gnome_mdi_child_add_view ()</title>
<indexterm zone="gnome-mdi-child-add-view" role="deprecated"><primary sortas="gnome_mdi_child_add_view">gnome_mdi_child_add_view</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gnome_mdi_child_add_view            (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child);</programlisting>
<warning><para><literal>gnome_mdi_child_add_view</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a new view of a child (a GtkWidget) adds it to the list
of the views and returns a pointer to it. Virtual function
that has to be specified for classes derived from GnomeMDIChild
is used to create the new view.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>mdi_child</parameter>&#160;:</term>
<listitem><simpara> A pointer to a GnomeMDIChild object.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara>
A pointer to the new view.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-child-remove-view" role="function" condition="deprecated:">
<title>gnome_mdi_child_remove_view ()</title>
<indexterm zone="gnome-mdi-child-remove-view" role="deprecated"><primary sortas="gnome_mdi_child_remove_view">gnome_mdi_child_remove_view</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_child_remove_view         (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         <link linkend="GtkWidget">GtkWidget</link> *view);</programlisting>
<warning><para><literal>gnome_mdi_child_remove_view</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Removes view <parameter>view</parameter> from the list of <parameter>mdi_child</parameter>'s views and
unrefs it.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>mdi_child</parameter>&#160;:</term>
<listitem><simpara> A pointer to a GnomeMDIChild object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>view</parameter>&#160;:</term>
<listitem><simpara> View to be removed.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-child-set-name" role="function" condition="deprecated:">
<title>gnome_mdi_child_set_name ()</title>
<indexterm zone="gnome-mdi-child-set-name" role="deprecated"><primary sortas="gnome_mdi_child_set_name">gnome_mdi_child_set_name</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_child_set_name            (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         const <link linkend="gchar">gchar</link> *name);</programlisting>
<warning><para><literal>gnome_mdi_child_set_name</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Changes name of <parameter>mdi_child</parameter> to <parameter>name</parameter>. <parameter>name</parameter> is duplicated and stored
in <parameter>mdi_child</parameter>. If <parameter>mdi_child</parameter> has already been added to GnomeMDI,
it also takes care of updating it.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>mdi_child</parameter>&#160;:</term>
<listitem><simpara> A pointer to a GnomeMDIChild object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara> String containing the new name for the child.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-child-set-menu-template" role="function" condition="deprecated:">
<title>gnome_mdi_child_set_menu_template ()</title>
<indexterm zone="gnome-mdi-child-set-menu-template" role="deprecated"><primary sortas="gnome_mdi_child_set_menu_template">gnome_mdi_child_set_menu_template</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_child_set_menu_template   (<link linkend="GnomeMDIChild">GnomeMDIChild</link> *mdi_child,
                                                         <link linkend="GnomeUIInfo">GnomeUIInfo</link> *menu_tmpl);</programlisting>
<warning><para><literal>gnome_mdi_child_set_menu_template</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the template for menus that are added and removed when differrent
children get activated. This way, each child can modify the MDI menubar
to suit its needs. If no template is set, the create_menus virtual
function will be used for creating these menus (it has to return a
GList of menu items). If no such function is specified, the menubar will
be unchanged by MDI children.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>mdi_child</parameter>&#160;:</term>
<listitem><simpara> A pointer to a GnomeMDIChild object.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>menu_tmpl</parameter>&#160;:</term>
<listitem><simpara> A GnomeUIInfo array describing the child specific menus.
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
