GnomeMDIGenericChild

GnomeMDIGenericChild

Functions

Types and Values

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkObject
            ╰── GnomeMDIChild
                ╰── GnomeMDIGenericChild

Includes

#include <libgnomeui/libgnomeui.h>

Description

Functions

gnome_mdi_generic_child_new ()

GnomeMDIGenericChild *
gnome_mdi_generic_child_new (const gchar *name);

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.

Parameters

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

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.

Parameters

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,
                                GDestroyNotify notify);

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

Parameters

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

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.

Parameters

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,
                                GDestroyNotify notify);

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

Parameters

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

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.

Parameters

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,
                                GDestroyNotify notify);

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

Parameters

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

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.

Parameters

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,
                                GDestroyNotify notify);

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

Parameters

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

 

Types and Values

struct GnomeMDIGenericChild

struct GnomeMDIGenericChild;

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