Libbonobo Reference Manual: bonobo-shlib-factory

bonobo-shlib-factory

Functions

BonoboShlibFactory *	bonobo_shlib_factory_construct ()
BonoboShlibFactory *	bonobo_shlib_factory_new ()
BonoboShlibFactory *	bonobo_shlib_factory_new_closure ()
Bonobo_Unknown	bonobo_shlib_factory_std ()
#define	BONOBO_OAF_SHLIB_FACTORY()
#define	BONOBO_OAF_SHLIB_FACTORY_MULTI()
#define	BONOBO_ACTIVATION_SHLIB_FACTORY()

Types and Values

struct	BonoboShlibFactory
	BonoboShlibFactoryClass

Object Hierarchy

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

Description

Functions

bonobo_shlib_factory_construct ()

BonoboShlibFactory *
bonobo_shlib_factory_construct (BonoboShlibFactory *factory,
                                const char *act_iid,
                                PortableServer_POA poa,
                                gpointer act_impl_ptr,
                                GClosure *closure);

Initializes c_factory with the supplied data.

Parameters

factory	The object to be initialized.
act_iid	The GOAD id that the new factory will implement.
poa	the poa.
act_impl_ptr	Activation shlib handle
closure	The closure used to create new GnomeShlib object instances.

Returns

The initialized BonoboShlibFactory object.

bonobo_shlib_factory_new ()

BonoboShlibFactory *
bonobo_shlib_factory_new (const char *component_id,
                          PortableServer_POA poa,
                          gpointer act_impl_ptr,
                          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::Shlib interface. The factory callback routine is passed the data pointer to provide the creation function with some state information.

Parameters

component_id	The GOAD id that this factory implements
poa	the poa.
act_impl_ptr	Activation shlib handle
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 BonoboShlibFactory object that has an activated Bonobo::ShlibFactory object that has registered with the GNOME name server.

bonobo_shlib_factory_new_closure ()

BonoboShlibFactory *
bonobo_shlib_factory_new_closure (const char *act_iid,
                                  PortableServer_POA poa,
                                  gpointer act_impl_ptr,
                                  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::Shlib 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
poa	the poa.
act_impl_ptr	Activation shlib handle
factory_closure	A closure which is used to create new BonoboObject instances.

Returns

A BonoboShlibFactory object that has an activated Bonobo::ShlibFactory object that has registered with the GNOME name server.

bonobo_shlib_factory_std ()

Bonobo_Unknown
bonobo_shlib_factory_std (const char *component_id,
                          PortableServer_POA poa,
                          gpointer act_impl_ptr,
                          BonoboFactoryCallback factory_cb,
                          gpointer user_data,
                          CORBA_Environment *ev);

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

Returns

0 on success, 1 on failure.

BONOBO_OAF_SHLIB_FACTORY()

#define             BONOBO_OAF_SHLIB_FACTORY(oafiid, descr, fn, data)

Deprecated. See BONOBO_ACTIVATION_SHLIB_FACTORY().

BONOBO_OAF_SHLIB_FACTORY_MULTI()

#define             BONOBO_OAF_SHLIB_FACTORY_MULTI(oafiid, descr, fn, data)

Deprecated. See BONOBO_ACTIVATION_SHLIB_FACTORY().

BONOBO_ACTIVATION_SHLIB_FACTORY()

#define             BONOBO_ACTIVATION_SHLIB_FACTORY(oafiid, descr, fn, data)

Macro that includes all boiler-plate code necessary to create an shlib type factory.

Parameters

oafiid	The factory's OAFIID
descr	Description of the factory
fn	Function (BonoboFactoryCallback) responsible for intantiating components
data	Additional data to be passed to the callback

Types and Values

struct BonoboShlibFactory

struct BonoboShlibFactory;

BonoboShlibFactoryClass

typedef struct {
	BonoboGenericFactoryClass parent_class;
} BonoboShlibFactoryClass;