Top | ![]() |
![]() |
![]() |
![]() |
void | (*BonoboAppHookFunc) () |
BonoboApplication * | bonobo_application_new () |
void | bonobo_application_register_message () |
void | bonobo_application_register_message_v () |
void | bonobo_application_register_message_va () |
gint | bonobo_application_new_instance () |
gchar * | bonobo_application_create_serverinfo () |
Bonobo_RegistrationResult | bonobo_application_register_unique () |
void | bonobo_application_add_hook () |
void | bonobo_application_remove_hook () |
BonoboApplication *
bonobo_application_new (const char *name
);
Creates a new BonoboApplication object.
void bonobo_application_register_message (BonoboApplication *app
,const gchar *name
,const gchar *description
,GClosure *opt_closure
,GType return_type
,GType first_arg_type
,...
);
Registers a new message type that the application supports.
app |
a BonoboApplication |
|
name |
message string identifier |
|
description |
a string containing a human readable description of the message |
|
opt_closure |
a GClosure that will be called for this message, or
|
|
return_type |
Message return GType. |
|
first_arg_type |
GType of first argument of message, or |
|
... |
|
void bonobo_application_register_message_v (BonoboApplication *app
,const gchar *name
,const gchar *description
,GClosure *opt_closure
,GType return_type
,GType const arg_types[]
);
See bonobo_application_register_message()
.
app |
a BonoboApplication |
|
name |
message string identifier |
|
description |
a string containing a human readable description of the message |
|
opt_closure |
a GClosure that will be called for this message, or |
|
return_type |
Message return GType. |
|
arg_types |
|
void bonobo_application_register_message_va (BonoboApplication *app
,const gchar *name
,const gchar *description
,GClosure *opt_closure
,GType return_type
,GType first_arg_type
,va_list var_args
);
See bonobo_application_register_message()
.
app |
a BonoboApplication |
|
name |
message string identifier |
|
description |
a string containing a human readable description of the message |
|
opt_closure |
a GClosure that will be called for this message, or
|
|
return_type |
Message return GType. |
|
first_arg_type |
GType of first argument of message, or |
|
var_args |
|
gint bonobo_application_new_instance (BonoboApplication *app
,gint argc
,gchar *argv[]
);
Emit the "new-instance" signal of the BonoboApplication with the given arguments.
gchar * bonobo_application_create_serverinfo (BonoboApplication *app
,gchar const *envp[]
);
This utility function provides a simple way to contruct a valid serverinfo XML string.
app |
a BonoboApplication |
|
envp |
|
Bonobo_RegistrationResult bonobo_application_register_unique (BonoboApplication *app
,gchar const *serverinfo
,BonoboAppClient **client
);
Try to register the running application, or check for an existing application already registered and get a reference to it. Applications already running but on different environments (as defined by the bonobo:environenment server property) than this one are ignored and do not interfere.
If the registration attempt indicates that another instance of this
application is already running, then the output variable
client
will receive a newly created BonoboAppClient
associated with the running application. Otherwise, *client
is
set to NULL
.
app |
a BonoboApplication instance |
|
serverinfo |
the XML server
description. |
|
client |
output parameter that will contain a client object, in
case another instance has already running, or |
void bonobo_application_add_hook (BonoboAppHookFunc func
,gpointer data
);
Add a hook function to be called whenever a new BonoboApplication instance is created.
void bonobo_application_remove_hook (BonoboAppHookFunc func
,gpointer data
);
Removes a hook function previously set with bonobo_application_add_hook()
.