MateMDIGenericChild

MateMDIGenericChild

Synopsis

#include <libmateui/libmateui.h>

struct              MateMDIGenericChild;
MateMDIGenericChild * mate_mdi_generic_child_new      (const gchar *name);
void                mate_mdi_generic_child_set_view_creator
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildViewCreator func,
                                                         gpointer data);
void                mate_mdi_generic_child_set_view_creator_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildViewCreator func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);
void                mate_mdi_generic_child_set_menu_creator
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildMenuCreator func,
                                                         gpointer data);
void                mate_mdi_generic_child_set_menu_creator_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildMenuCreator func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);
void                mate_mdi_generic_child_set_config_func
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildConfigFunc func,
                                                         gpointer data);
void                mate_mdi_generic_child_set_config_func_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildConfigFunc func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);
void                mate_mdi_generic_child_set_label_func
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildLabelFunc func,
                                                         gpointer data);
void                mate_mdi_generic_child_set_label_func_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildLabelFunc func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----MateMDIChild
                     +----MateMDIGenericChild

Description

Details

struct MateMDIGenericChild

struct MateMDIGenericChild;

Warning

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


mate_mdi_generic_child_new ()

MateMDIGenericChild * mate_mdi_generic_child_new      (const gchar *name);

Warning

mate_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 &MateMDIChild).

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 &MateMDIGenericChild object.

mate_mdi_generic_child_set_view_creator ()

void                mate_mdi_generic_child_set_view_creator
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildViewCreator func,
                                                         gpointer data);

Warning

mate_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 &MateMDIGenericChild must have a view creator.

child :

the mdi child object

func :

a function used to create views

data :

optional user data.

mate_mdi_generic_child_set_view_creator_full ()

void                mate_mdi_generic_child_set_view_creator_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildViewCreator func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);

Warning

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

Similar to mate_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.

mate_mdi_generic_child_set_menu_creator ()

void                mate_mdi_generic_child_set_menu_creator
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildMenuCreator func,
                                                         gpointer data);

Warning

mate_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 &MateMDIGenericChild 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

mate_mdi_generic_child_set_menu_creator_full ()

void                mate_mdi_generic_child_set_menu_creator_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildMenuCreator func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);

Warning

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

This function is similar to mate_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

mate_mdi_generic_child_set_config_func ()

void                mate_mdi_generic_child_set_config_func
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildConfigFunc func,
                                                         gpointer data);

Warning

mate_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 &MateMDIGenericChild 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

mate_mdi_generic_child_set_config_func_full ()

void                mate_mdi_generic_child_set_config_func_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildConfigFunc func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);

Warning

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

A function similar to mate_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

mate_mdi_generic_child_set_label_func ()

void                mate_mdi_generic_child_set_label_func
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildLabelFunc func,
                                                         gpointer data);

Warning

mate_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 &MateMDIGenericChild doesn't require a label function.

child :

a mdi child object

func :

a function

data :

optional user data

mate_mdi_generic_child_set_label_func_full ()

void                mate_mdi_generic_child_set_label_func_full
                                                        (MateMDIGenericChild *child,
                                                         MateMDIChildLabelFunc func,
                                                         GtkCallbackMarshal marshal,
                                                         gpointer data,
                                                         GDestroyNotify notify);

Warning

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

Similar to mate_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