## GnomeMDIGenericChild

GnomeMDIGenericChild —

## Synopsis

    #include <libgnomeui/libgnomeui.h>

                GnomeMDIGenericChild;
    GnomeMDIGenericChild* gnome_mdi_generic_child_new
                                                (const gchar *name);
    void        gnome_mdi_generic_child_set_view_creator
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildViewCreator func,
                                                 gpointer data);
    void        gnome_mdi_generic_child_set_view_creator_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildViewCreator func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);
    void        gnome_mdi_generic_child_set_menu_creator
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildMenuCreator func,
                                                 gpointer data);
    void        gnome_mdi_generic_child_set_menu_creator_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildMenuCreator func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);
    void        gnome_mdi_generic_child_set_config_func
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildConfigFunc func,
                                                 gpointer data);
    void        gnome_mdi_generic_child_set_config_func_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildConfigFunc func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);
    void        gnome_mdi_generic_child_set_label_func
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildLabelFunc func,
                                                 gpointer data);
    void        gnome_mdi_generic_child_set_label_func_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildLabelFunc func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GnomeMDIChild
                         +----GnomeMDIGenericChild

## Description

## Details

### GnomeMDIGenericChild

    typedef struct _GnomeMDIGenericChild GnomeMDIGenericChild;

### Warning

`GnomeMDIGenericChild` is deprecated and should not be used in newly-written code.

### gnome_mdi_generic_child_new ()

    GnomeMDIGenericChild* gnome_mdi_generic_child_new
                                                (const gchar *name);

### Warning

`gnome_mdi_generic_child_new` is deprecated and should not be used in newly-written code.

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 &GnomeMDIChild).

After creation, you will need to set, at a minimum, the view creator function.

`name` : | the name of this MDI child.
Returns : | A newly created &GnomeMDIGenericChild object.

### gnome_mdi_generic_child_set_view_creator ()

    void        gnome_mdi_generic_child_set_view_creator
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildViewCreator func,
                                                 gpointer data);

### Warning

`gnome_mdi_generic_child_set_view_creator` is deprecated and should not be used in newly-written code.

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).

A &GnomeMDIGenericChild must have a view creator.

`child` : | the mdi child object
`func` : | a function used to create views
`data` : | optional user data.

### gnome_mdi_generic_child_set_view_creator_full ()

    void        gnome_mdi_generic_child_set_view_creator_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildViewCreator func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);

### Warning

`gnome_mdi_generic_child_set_view_creator_full` is deprecated and should not be used in newly-written code.

Similar to `gnome_mdi_generic_child_set_view_creator()`, except that it gives more control to the programmer. If `marshal` is not `NULL`, then it will be called instead of `func`.

The &GtkArg array passed to `marshal` will be of length 2. The first element will be `child`, and the second is the return value (a pointer to a &GtkWidget).

`child` : | the mdi child object
`func` : | a function to create views (not used if `marshal` != `NULL`)
`marshal` : | a callback marshaller
`data` : | optional user data
`notify` : | a function used to free the user data.

### gnome_mdi_generic_child_set_menu_creator ()

    void        gnome_mdi_generic_child_set_menu_creator
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildMenuCreator func,
                                                 gpointer data);

### Warning

`gnome_mdi_generic_child_set_menu_creator` is deprecated and should not be used in newly-written code.

Sets the function used to create child specific menus. The function should return a &GList of the menus created.

A &GnomeMDIGenericChild doesn't require a menu creator.

`child` : | the mdi child object
`func` : | a function to create a list of child specific menus
`data` : | optional user data

### gnome_mdi_generic_child_set_menu_creator_full ()

    void        gnome_mdi_generic_child_set_menu_creator_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildMenuCreator func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);

### Warning

`gnome_mdi_generic_child_set_menu_creator_full` is deprecated and should not be used in newly-written code.

This function is similar to `gnome_mdi_generic_child_set_menu_creator()`, but gives extra flexibility to the programmer, in the form of a a destroy notify for the user data, and a callback marshaller.

The &GtkArg array passed to `marshal` is of length 3. The first element will be `child`, the second will be a view of `child`, and the third is the return value (a pointer to the returned GList).

`child` : | the mdi child object
`func` : | a menu creator function (not used if `marshal` != `NULL`)
`marshal` : | a callback marshaller
`data` : | optional user data
`notify` : | a destroy notify for the data

### gnome_mdi_generic_child_set_config_func ()

    void        gnome_mdi_generic_child_set_config_func
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildConfigFunc func,
                                                 gpointer data);

### Warning

`gnome_mdi_generic_child_set_config_func` is deprecated and should not be used in newly-written code.

Sets the function used to get the config key used for session saves.

A &GnomeMDIGenericChild doesn't require a config func.

`child` : | the mdi child object
`func` : | a function to set the config key for session saves
`data` : | optional user data

### gnome_mdi_generic_child_set_config_func_full ()

    void        gnome_mdi_generic_child_set_config_func_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildConfigFunc func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);

### Warning

`gnome_mdi_generic_child_set_config_func_full` is deprecated and should not be used in newly-written code.

A function similar to `gnome_mdi_generic_child_set_config_func()`, except it gives more control to the programmer.

The &GtkArg array passed to `marshal` is of length 2. The first element is `child`, and the second is the return value (a pointer to a string).

`child` : | the mdi child object
`func` : | a function (not used if `marshal` != `NULL`)
`marshal` : | a callback marshaller
`data` : | optional user data
`notify` : | a destroy notify for the user data

### gnome_mdi_generic_child_set_label_func ()

    void        gnome_mdi_generic_child_set_label_func
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildLabelFunc func,
                                                 gpointer data);

### Warning

`gnome_mdi_generic_child_set_label_func` is deprecated and should not be used in newly-written code.

Sets the function used to set (or modify) the label for `child`. The first argument to `func` is `child`. If a label exists, it will be passed to `func` as the second argument, otherwise, `NULL` is passed. The function should return the modified label.

A &GnomeMDIGenericChild doesn't require a label function.

`child` : | a mdi child object
`func` : | a function
`data` : | optional user data

### gnome_mdi_generic_child_set_label_func_full ()

    void        gnome_mdi_generic_child_set_label_func_full
                                                (GnomeMDIGenericChild *child,
                                                 GnomeMDIChildLabelFunc func,
                                                 GtkCallbackMarshal marshal,
                                                 gpointer data,
                                                 GtkDestroyNotify notify);

### Warning

`gnome_mdi_generic_child_set_label_func_full` is deprecated and should not be used in newly-written code.

Similar to `gnome_mdi_generic_child_set_label_func()`, except it gives more flexibility to the programmer.

The &GtkArg array passed to `marshal` is of length 3. The first argument is `child`, the second is the old widget (or `NULL`), and the third is the return value (a pointer to a &GtkWidget).

`child` : | the mdi child object
`func` : | a function (not used if `marshal` != `NULL`)
`marshal` : | a callback marshaller
`data` : | optional user data
`notify` : | a destroy notify for the data