bonobo-generic-factory: Libbonobo Reference Manual

bonobo-generic-factory

Functions

BonoboObject *	(*BonoboFactoryCallback) ()
BonoboGenericFactory *	bonobo_generic_factory_new ()
BonoboGenericFactory *	bonobo_generic_factory_new_closure ()
BonoboGenericFactory *	bonobo_generic_factory_construct ()
void	bonobo_generic_factory_construct_noreg ()
int	bonobo_generic_factory_main ()
int	bonobo_generic_factory_main_timeout ()
#define	BONOBO_FACTORY_INIT()
#define	BONOBO_OAF_FACTORY()
#define	BONOBO_OAF_FACTORY_MULTI()
#define	BONOBO_ACTIVATION_FACTORY()
#define	BONOBO_ACTIVATION_FACTORY_TIMEOUT()

Object Hierarchy

    GObject
    ╰── BonoboObject
        ╰── BonoboGenericFactory
            ╰── BonoboShlibFactory

Description

Functions

BonoboFactoryCallback ()

BonoboObject *
(*BonoboFactoryCallback) (BonoboGenericFactory *factory,
                          const char *component_id,
                          gpointer closure);

bonobo_generic_factory_new ()

BonoboGenericFactory *
bonobo_generic_factory_new (const char *act_iid,
                            BonoboFactoryCallback factory_cb,
                            gpointer user_data);

This is a helper routine that simplifies the creation of factory objects for GNOME objects. The factory function will be invoked by the CORBA server when a request arrives to create a new instance of an object supporting the Bonobo::Generic interface. The factory callback routine is passed the data pointer to provide the creation function with some state information.

Parameters

act_iid	The GOAD id that this factory implements
factory_cb	A callback which is used to create new BonoboObject instances.
user_data	The closure data to be passed to the `factory` callback routine.

Returns

A BonoboGenericFactory object that has an activated Bonobo::GenericFactory object that has registered with the GNOME name server.

bonobo_generic_factory_new_closure ()

BonoboGenericFactory *
bonobo_generic_factory_new_closure (const char *act_iid,
                                    GClosure *factory_closure);

This is a helper routine that simplifies the creation of factory objects for GNOME objects. The factory_closure closure will be invoked by the CORBA server when a request arrives to create a new instance of an object supporting the Bonobo::Generic interface. The factory callback routine is passed the data pointer to provide the creation function with some state information.

Parameters

act_iid	The GOAD id that this factory implements
factory_closure	A closure which is used to create new BonoboObject instances.

Returns

A BonoboGenericFactory object that has an activated Bonobo::GenericFactory object that has registered with the GNOME name server.

bonobo_generic_factory_construct ()

BonoboGenericFactory *
bonobo_generic_factory_construct (BonoboGenericFactory *factory,
                                  const char *act_iid,
                                  GClosure *factory_closure);

Initializes c_factory with and registers the new factory with the name server.

Parameters

factory	The object to be initialized.
act_iid	The Bonobo activation id that the new factory will implement. Bonobo::GenericFactory interface and which will be used to construct this BonoboGenericFactory Gtk object.
factory_closure	A Multi object factory closure.

Returns

The initialized BonoboGenericFactory object or NULL if already registered.

bonobo_generic_factory_construct_noreg ()

void
bonobo_generic_factory_construct_noreg
                               (BonoboGenericFactory *factory,
                                const char *act_iid,
                                GClosure *factory_closure);

Initializes c_factory with the supplied closure and iid.

Parameters

factory	The object to be initialized.
act_iid	The GOAD id that the new factory will implement.
factory_closure	A Multi object factory closure.

bonobo_generic_factory_main ()

int
bonobo_generic_factory_main (const char *act_iid,
                             BonoboFactoryCallback factory_cb,
                             gpointer user_data);

A Generic 'main' routine so we don't stick a load of code inside a public macro. See also bonobo_generic_factory_main_timeout().

Parameters

act_iid	the oaf iid of the factory
factory_cb	the factory callback
user_data	a user data pointer

Returns

0 on success, 1 on failure.

bonobo_generic_factory_main_timeout ()

int
bonobo_generic_factory_main_timeout (const char *act_iid,
                                     BonoboFactoryCallback factory_cb,
                                     gpointer user_data,
                                     guint quit_timeout);

A Generic 'main' routine so we don't stick a load of code inside a public macro.

Parameters

act_iid	the oaf iid of the factory
factory_cb	the factory callback
user_data	a user data pointer
quit_timeout	ammount of time to wait (miliseconds) after all objects have been released before quitting the main loop.

Returns

0 on success, 1 on failure.

BONOBO_FACTORY_INIT()

#define             BONOBO_FACTORY_INIT(descr, version, argcp, argv)

BONOBO_OAF_FACTORY()

#define             BONOBO_OAF_FACTORY(oafiid, descr, version, callback, data)

BONOBO_OAF_FACTORY_MULTI()

#define             BONOBO_OAF_FACTORY_MULTI(oafiid, descr, version, callback, data)

BONOBO_ACTIVATION_FACTORY()

#define             BONOBO_ACTIVATION_FACTORY(oafiid, descr, version, callback, data)

BONOBO_ACTIVATION_FACTORY_TIMEOUT()

#define             BONOBO_ACTIVATION_FACTORY_TIMEOUT(oafiid, descr, version, callback, data, quit_timeout)