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

<refnamediv>
<refname>GnomeMDIGenericChild</refname>
<refpurpose></refpurpose>
</refnamediv>

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

<synopsis>

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

                    <link linkend="GnomeMDIGenericChild-struct">GnomeMDIGenericChild</link>;
<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> * <link linkend="gnome-mdi-generic-child-new">gnome_mdi_generic_child_new</link>      (const <link linkend="gchar">gchar</link> *name);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-view-creator">gnome_mdi_generic_child_set_view_creator</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildViewCreator">GnomeMDIChildViewCreator</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-view-creator-full">gnome_mdi_generic_child_set_view_creator_full</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildViewCreator">GnomeMDIChildViewCreator</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-menu-creator">gnome_mdi_generic_child_set_menu_creator</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildMenuCreator">GnomeMDIChildMenuCreator</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-menu-creator-full">gnome_mdi_generic_child_set_menu_creator_full</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildMenuCreator">GnomeMDIChildMenuCreator</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-config-func">gnome_mdi_generic_child_set_config_func</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildConfigFunc">GnomeMDIChildConfigFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-config-func-full">gnome_mdi_generic_child_set_config_func_full</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildConfigFunc">GnomeMDIChildConfigFunc</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-label-func">gnome_mdi_generic_child_set_label_func</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildLabelFunc">GnomeMDIChildLabelFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);
<link linkend="void">void</link>                <link linkend="gnome-mdi-generic-child-set-label-func-full">gnome_mdi_generic_child_set_label_func_full</link>
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildLabelFunc">GnomeMDIChildLabelFunc</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GnomeMDIGenericChild.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>
               +----<link linkend="GnomeMDIChild">GnomeMDIChild</link>
                     +----GnomeMDIGenericChild
</synopsis>
</refsect1>








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

<refsect1 id="GnomeMDIGenericChild.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GnomeMDIGenericChild-struct" role="struct">
<title>GnomeMDIGenericChild</title>
<indexterm zone="GnomeMDIGenericChild-struct" role="deprecated"><primary sortas="GnomeMDIGenericChild">GnomeMDIGenericChild</primary></indexterm><programlisting>typedef struct _GnomeMDIGenericChild GnomeMDIGenericChild;</programlisting>
<warning><para><literal>GnomeMDIGenericChild</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
</para></refsect2>
<refsect2 id="gnome-mdi-generic-child-new" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_new ()</title>
<indexterm zone="gnome-mdi-generic-child-new" role="deprecated"><primary sortas="gnome_mdi_generic_child_new">gnome_mdi_generic_child_new</primary></indexterm><programlisting><link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> * gnome_mdi_generic_child_new      (const <link linkend="gchar">gchar</link> *name);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_new</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Creates a new mdi child, which has the ability to set view creators, etc
on an instance basis (rather than on a class basis like &amp;GnomeMDIChild).
</para>
<para>
After creation, you will need to set, at a minimum, the view creator
function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>name</parameter>&#160;:</term>
<listitem><simpara> the name of this MDI child.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A newly created &amp;GnomeMDIGenericChild object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-view-creator" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_view_creator ()</title>
<indexterm zone="gnome-mdi-generic-child-set-view-creator" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_view_creator">gnome_mdi_generic_child_set_view_creator</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_view_creator
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildViewCreator">GnomeMDIChildViewCreator</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_view_creator</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This function sets the function that is used to create new views for this
particular mdi child object.  The function should return a newly created
widget (the view).
</para>
<para>
A &amp;GnomeMDIGenericChild must have a view creator.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function used to create views
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-view-creator-full" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_view_creator_full ()</title>
<indexterm zone="gnome-mdi-generic-child-set-view-creator-full" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_view_creator_full">gnome_mdi_generic_child_set_view_creator_full</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_view_creator_full
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildViewCreator">GnomeMDIChildViewCreator</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_view_creator_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Similar to <link linkend="gnome-mdi-generic-child-set-view-creator"><function>gnome_mdi_generic_child_set_view_creator()</function></link>, except that it gives
more control to the programmer.  If <parameter>marshal</parameter> is not <link linkend="NULL--CAPS"><literal>NULL</literal></link>, then it will
be called instead of <parameter>func</parameter>.
</para>
<para>
The &amp;GtkArg array passed to <parameter>marshal</parameter> will be of length 2.  The first
element will be <parameter>child</parameter>, and the second is the return value (a pointer to
a &amp;GtkWidget).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function to create views (not used if <parameter>marshal</parameter> != <link linkend="NULL--CAPS"><literal>NULL</literal></link>)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>marshal</parameter>&#160;:</term>
<listitem><simpara> a callback marshaller
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>notify</parameter>&#160;:</term>
<listitem><simpara> a function used to free the user data.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-menu-creator" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_menu_creator ()</title>
<indexterm zone="gnome-mdi-generic-child-set-menu-creator" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_menu_creator">gnome_mdi_generic_child_set_menu_creator</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_menu_creator
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildMenuCreator">GnomeMDIChildMenuCreator</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_menu_creator</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the function used to create child specific menus.  The function
should return a &amp;GList of the menus created.
</para>
<para>
A &amp;GnomeMDIGenericChild doesn't require a menu creator.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function to create a list of child specific menus
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-menu-creator-full" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_menu_creator_full ()</title>
<indexterm zone="gnome-mdi-generic-child-set-menu-creator-full" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_menu_creator_full">gnome_mdi_generic_child_set_menu_creator_full</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_menu_creator_full
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildMenuCreator">GnomeMDIChildMenuCreator</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_menu_creator_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
This function is similar to <link linkend="gnome-mdi-generic-child-set-menu-creator"><function>gnome_mdi_generic_child_set_menu_creator()</function></link>,
but gives extra flexibility to the programmer, in the form of a a
destroy notify for the user data, and a callback marshaller.
</para>
<para>
The &amp;GtkArg array passed to <parameter>marshal</parameter> is of length 3.  The first element
will be <parameter>child</parameter>, the second will be a view of <parameter>child</parameter>, and the third is the
return value (a pointer to the returned GList).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a menu creator function (not used if <parameter>marshal</parameter> != <link linkend="NULL--CAPS"><literal>NULL</literal></link>)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>marshal</parameter>&#160;:</term>
<listitem><simpara> a callback marshaller
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>notify</parameter>&#160;:</term>
<listitem><simpara> a destroy notify for the data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-config-func" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_config_func ()</title>
<indexterm zone="gnome-mdi-generic-child-set-config-func" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_config_func">gnome_mdi_generic_child_set_config_func</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_config_func
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildConfigFunc">GnomeMDIChildConfigFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_config_func</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the function used to get the config key used for session saves.
</para>
<para>
A &amp;GnomeMDIGenericChild doesn't require a config func.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function to set the config key for session saves
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-config-func-full" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_config_func_full ()</title>
<indexterm zone="gnome-mdi-generic-child-set-config-func-full" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_config_func_full">gnome_mdi_generic_child_set_config_func_full</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_config_func_full
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildConfigFunc">GnomeMDIChildConfigFunc</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_config_func_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
A function similar to <link linkend="gnome-mdi-generic-child-set-config-func"><function>gnome_mdi_generic_child_set_config_func()</function></link>, except
it gives more control to the programmer.
</para>
<para>
The &amp;GtkArg array passed to <parameter>marshal</parameter> is of length 2.  The first element is
<parameter>child</parameter>, and the second is the return value (a pointer to a string).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function (not used if <parameter>marshal</parameter> != <link linkend="NULL--CAPS"><literal>NULL</literal></link>)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>marshal</parameter>&#160;:</term>
<listitem><simpara> a callback marshaller
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>notify</parameter>&#160;:</term>
<listitem><simpara> a destroy notify for the user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-label-func" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_label_func ()</title>
<indexterm zone="gnome-mdi-generic-child-set-label-func" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_label_func">gnome_mdi_generic_child_set_label_func</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_label_func
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildLabelFunc">GnomeMDIChildLabelFunc</link> func,
                                                         <link linkend="gpointer">gpointer</link> data);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_label_func</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Sets the function used to set (or modify) the label for <parameter>child</parameter>.  The
first argument to <parameter>func</parameter> is <parameter>child</parameter>.  If a label exists, it will be passed
to <parameter>func</parameter> as the second argument, otherwise, <link linkend="NULL--CAPS"><literal>NULL</literal></link> is passed.  The
function should return the modified label.
</para>
<para>
A &amp;GnomeMDIGenericChild doesn't require a label function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> a mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gnome-mdi-generic-child-set-label-func-full" role="function" condition="deprecated:">
<title>gnome_mdi_generic_child_set_label_func_full ()</title>
<indexterm zone="gnome-mdi-generic-child-set-label-func-full" role="deprecated"><primary sortas="gnome_mdi_generic_child_set_label_func_full">gnome_mdi_generic_child_set_label_func_full</primary></indexterm><programlisting><link linkend="void">void</link>                gnome_mdi_generic_child_set_label_func_full
                                                        (<link linkend="GnomeMDIGenericChild">GnomeMDIGenericChild</link> *child,
                                                         <link linkend="GnomeMDIChildLabelFunc">GnomeMDIChildLabelFunc</link> func,
                                                         <link linkend="GtkCallbackMarshal">GtkCallbackMarshal</link> marshal,
                                                         <link linkend="gpointer">gpointer</link> data,
                                                         <link linkend="GDestroyNotify">GDestroyNotify</link> notify);</programlisting>
<warning><para><literal>gnome_mdi_generic_child_set_label_func_full</literal> is deprecated and should not be used in newly-written code.</para></warning>
<para>
Similar to <link linkend="gnome-mdi-generic-child-set-label-func"><function>gnome_mdi_generic_child_set_label_func()</function></link>, except it gives more
flexibility to the programmer.
</para>
<para>
The &amp;GtkArg array passed to <parameter>marshal</parameter> is of length 3.  The first argument
is <parameter>child</parameter>, the second is the old widget (or <link linkend="NULL--CAPS"><literal>NULL</literal></link>), and the third is the
return value (a pointer to a &amp;GtkWidget).</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> the mdi child object
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>func</parameter>&#160;:</term>
<listitem><simpara> a function (not used if <parameter>marshal</parameter> != <link linkend="NULL--CAPS"><literal>NULL</literal></link>)
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>marshal</parameter>&#160;:</term>
<listitem><simpara> a callback marshaller
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>data</parameter>&#160;:</term>
<listitem><simpara> optional user data
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>notify</parameter>&#160;:</term>
<listitem><simpara> a destroy notify for the data
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
