<HTML
><HEAD
><TITLE
>GnomeMDIGenericChild</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="GNOME Widgets and Objects"
HREF="gnome-objects.html"><LINK
REL="PREVIOUS"
TITLE="GnomeMDIChild"
HREF="gnomemdichild.html"><LINK
REL="NEXT"
TITLE="GnomeMDI"
HREF="gnomemdi.html"></HEAD
><BODY
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdichild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdi.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEMDIGENERICCHILD"
>GnomeMDIGenericChild</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN20244"
></A
><H2
>Name</H2
>GnomeMDIGenericChild&nbsp;--&nbsp;A generic <SPAN
CLASS="TYPE"
>GnomeMDI</SPAN
> child</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN20248"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;#include &lt;gnome.h&gt;


struct      <A
HREF="gnomemdigenericchild.html#GNOMEMDIGENERICCHILD-STRUCT"
>GnomeMDIGenericChild</A
>;
<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
>* <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-NEW"
>gnome_mdi_generic_child_new</A
>
                                            (<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
>gnome_mdi_generic_child_set_view_creator_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
>gnome_mdi_generic_child_set_menu_creator</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR-FULL"
>gnome_mdi_generic_child_set_menu_creator_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
>gnome_mdi_generic_child_set_config_func</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC-FULL"
>gnome_mdi_generic_child_set_config_func_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
>gnome_mdi_generic_child_set_label_func</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);
void        <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC-FULL"
>gnome_mdi_generic_child_set_label_func_full</A
>
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);&#13;</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20295"
></A
><H2
>Object Hierarchy</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
>&#13;  <GTKDOCLINK
HREF="GTKOBJECT"
>GtkObject</GTKDOCLINK
>
   +----<A
HREF="gnomemdichild.html"
>GnomeMDIChild</A
>
         +----GnomeMDIGenericChild</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20300"
></A
><H2
>Description</H2
><P
>    <SPAN
CLASS="TYPE"
>GnomeMDIGenericChild</SPAN
> is a subclass of <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
>
    that allows for defining of GnomeMDIChild's virtual functions on a per-instance
    rather than on per-class basis. Thus the programmer does not have to subclass
    <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> but can use <SPAN
CLASS="TYPE"
>GnomeMDIGenericChild</SPAN
> class
    directly.
  </P
><P
>    Only the view creating function is mandatory. It has to be set with
    <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>() or
    <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
>gnome_mdi_generic_child_set_view_creator_full</A
>(). A simple default implementation
    of notebook label creation is provided by <SPAN
CLASS="TYPE"
>GnomeMDIChild</SPAN
> class. The
    other two functions are optional.
  </P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN20311"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN20313"
></A
><H3
><A
NAME="GNOMEMDIGENERICCHILD-STRUCT"
></A
>struct GnomeMDIGenericChild</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>struct GnomeMDIGenericChild;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20318"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-NEW"
></A
>gnome_mdi_generic_child_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
>* gnome_mdi_generic_child_new
                                            (<GTKDOCLINK
HREF="GCHAR"
>gchar</GTKDOCLINK
> *name);</PRE
></TD
></TR
></TABLE
><P
>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).</P
><P
>After creation, you will need to set, at a minimum, the view creator
function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>name</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the name of this MDI child.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><I
CLASS="EMPHASIS"
>Returns</I
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly created &amp;GnomeMDIGenericChild object.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20340"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
></A
>gnome_mdi_generic_child_set_view_creator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_view_creator
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>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).</P
><P
>A &amp;GnomeMDIGenericChild must have a view creator.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function used to create views</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20367"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR-FULL"
></A
>gnome_mdi_generic_child_set_view_creator_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_view_creator_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDVIEWCREATOR"
>GnomeMDIChildViewCreator</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-VIEW-CREATOR"
>gnome_mdi_generic_child_set_view_creator</A
>(), except that it gives
more control to the programmer.  If <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is not <TT
CLASS="LITERAL"
>NULL</TT
>, then it will
be called instead of <TT
CLASS="PARAMETER"
><I
>func</I
></TT
>.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> will be of length 2.  The first
element will be <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the second is the return value (a pointer to
a &amp;GtkWidget).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to create views (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function used to free the user data.</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20412"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
></A
>gnome_mdi_generic_child_set_menu_creator ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_menu_creator
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to create child specific menus.  The function
should return a &amp;GList of the menus created.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a menu creator.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to create a list of child specific menus</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20439"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR-FULL"
></A
>gnome_mdi_generic_child_set_menu_creator_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_menu_creator_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDMENUCREATOR"
>GnomeMDIChildMenuCreator</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);</PRE
></TD
></TR
></TABLE
><P
>This function is similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-MENU-CREATOR"
>gnome_mdi_generic_child_set_menu_creator</A
>(),
but gives extra flexibility to the programmer, in the form of a a
destroy notify for the user data, and a callback marshaller.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 3.  The first element
will be <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, the second will be a view of <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the third is the
return value (a pointer to the returned GList).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a menu creator function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20482"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
></A
>gnome_mdi_generic_child_set_config_func ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_config_func
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to get the config key used for session saves.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a config func.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function to set the config key for session saves</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20509"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC-FULL"
></A
>gnome_mdi_generic_child_set_config_func_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_config_func_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDCONFIGFUNC"
>GnomeMDIChildConfigFunc</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);</PRE
></TD
></TR
></TABLE
><P
>A function similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-CONFIG-FUNC"
>gnome_mdi_generic_child_set_config_func</A
>(), except
it gives more control to the programmer.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 2.  The first element is
<TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, and the second is the return value (a pointer to a string).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the user data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20551"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
></A
>gnome_mdi_generic_child_set_label_func ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_label_func
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data);</PRE
></TD
></TR
></TABLE
><P
>Sets the function used to set (or modify) the label for <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>.  The
first argument to <TT
CLASS="PARAMETER"
><I
>func</I
></TT
> is <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>.  If a label exists, it will be passed
to <TT
CLASS="PARAMETER"
><I
>func</I
></TT
> as the second argument, otherwise, <TT
CLASS="LITERAL"
>NULL</TT
> is passed.  The
function should return the modified label.</P
><P
>A &amp;GnomeMDIGenericChild doesn't require a label function.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN20583"
></A
><H3
><A
NAME="GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC-FULL"
></A
>gnome_mdi_generic_child_set_label_func_full ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void        gnome_mdi_generic_child_set_label_func_full
                                            (<A
HREF="gnomemdigenericchild.html"
>GnomeMDIGenericChild</A
> *child,
                                             <A
HREF="gnomemdichild.html#GNOMEMDICHILDLABELFUNC"
>GnomeMDIChildLabelFunc</A
> func,
                                             <GTKDOCLINK
HREF="GTKCALLBACKMARSHAL"
>GtkCallbackMarshal</GTKDOCLINK
> marshal,
                                             <GTKDOCLINK
HREF="GPOINTER"
>gpointer</GTKDOCLINK
> data,
                                             <GTKDOCLINK
HREF="GTKDESTROYNOTIFY"
>GtkDestroyNotify</GTKDOCLINK
> notify);</PRE
></TD
></TR
></TABLE
><P
>Similar to <A
HREF="gnomemdigenericchild.html#GNOME-MDI-GENERIC-CHILD-SET-LABEL-FUNC"
>gnome_mdi_generic_child_set_label_func</A
>(), except it gives more
flexibility to the programmer.</P
><P
>The &amp;GtkArg array passed to <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> is of length 3.  The first argument
is <TT
CLASS="PARAMETER"
><I
>child</I
></TT
>, the second is the old widget (or <TT
CLASS="LITERAL"
>NULL</TT
>), and the third is the
return value (a pointer to a &amp;GtkWidget).</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>child</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the mdi child object</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>func</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a function (not used if <TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
> != <TT
CLASS="LITERAL"
>NULL</TT
>)</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>marshal</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a callback marshaller</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>data</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> optional user data</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>notify</I
></TT
>&nbsp;:</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a destroy notify for the data</TD
></TR
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomemdichild.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>&#60;&#60;&#60; Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="gnome-objects.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomemdi.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page &#62;&#62;&#62;</B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDIChild</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>GnomeMDI</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>