bonobo-main

bonobo-main — Bonobo initialization.

Synopsis




gboolean    bonobo_is_initialized           (void);
gboolean    bonobo_init                     (int *argc,
                                             char **argv);
gboolean    bonobo_init_full                (int *argc,
                                             char **argv,
                                             CORBA_ORB orb,
                                             PortableServer_POA poa,
                                             PortableServer_POAManager manager);
int         bonobo_debug_shutdown           (void);
void        bonobo_main                     (void);
void        bonobo_main_quit                (void);
gboolean    bonobo_activate                 (void);
void        bonobo_setup_x_error_handler    (void);
CORBA_ORB   bonobo_orb                      (void);
PortableServer_POA bonobo_poa               (void);
PortableServer_POAManager bonobo_poa_manager
                                            (void);

Description

Initialization functions for Bonobo applications.

Details

bonobo_is_initialized ()

gboolean    bonobo_is_initialized           (void);

This allows you to protect against double initialization in your code.

Returns : whether the ORB is initialized

bonobo_init ()

gboolean    bonobo_init                     (int *argc,
                                             char **argv);

Initializes the bonobo component model.

argc : a pointer to the number of arguments
argv : the array of arguments
Returns :TRUE on success, or FALSE on failure.

bonobo_init_full ()

gboolean    bonobo_init_full                (int *argc,
                                             char **argv,
                                             CORBA_ORB orb,
                                             PortableServer_POA poa,
                                             PortableServer_POAManager manager);

Initializes the bonobo document model. It requires at least the value for orb. If poa is CORBA_OBJECT_NIL, then the RootPOA will be used, in this case manager should be CORBA_OBJECT_NIL.

argc : a pointer to the number of arguments
argv : the array of arguments
orb :
poa :
manager :
Returns :TRUE on success, or FALSE on failure.

bonobo_debug_shutdown ()

int         bonobo_debug_shutdown           (void);

Returns :

bonobo_main ()

void        bonobo_main                     (void);

Activates the Bonobo POA Manager and enters the main event loop.


bonobo_main_quit ()

void        bonobo_main_quit                (void);

Quits the main event loop.


bonobo_activate ()

gboolean    bonobo_activate                 (void);

Activates the Bonobo POA manager registered by bonobo_init. This should be called at the end of application initialization. You do not need to call this function if you use bonobo_main().

Returns :TRUE on success, or FALSE on failure.

bonobo_setup_x_error_handler ()

void        bonobo_setup_x_error_handler    (void);


bonobo_orb ()

CORBA_ORB   bonobo_orb                      (void);

Returns the CORBA_ORB object that is being used by Bonobo.

Returns : The ORB used for this Bonobo application. The ORB is created in bonobo_init().

bonobo_poa ()

PortableServer_POA bonobo_poa               (void);

Returns the POA object that is being used by Bonobo.

Returns : The POA used for this Bonobo application. The POA is created when bonobo_init() is called.

bonobo_poa_manager ()

PortableServer_POAManager bonobo_poa_manager
                                            (void);

Returns the POA Manager object that is being used by Bonobo.

Returns : The POA Manager used for this Bonobo application. The POA Manager is created when bonobo_init() is called, but it is not activated until bonobo_main() is called.