bonobo-generic-factory

bonobo-generic-factory

Functions

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)