bonobo-application
a framework for unique application instance and automation
@app:
@data:
@name:
@Returns:
When @opt_closure is provided (and is non-%NULL) it takes care of calling the
callback function with the same arguments as registered for the message. On
the other hand if @opt_closure is %NULL, the function arguments are provided in
a #GValueArray. This enables defining functions that accept variable number of
arguments, but is perhaps a little more tedious to implement.
Function with a closure
static void
message_open_url_cb (BonoboApplication *app, const char *url, gboolean new_win)
{
...
}
...
closure = g_cclosure_new (G_CALLBACK (message_open_url_cb), NULL, NULL);
g_closure_set_marshal (closure, my_marshal_VOID__STRING_BOOLEAN);
bonobo_application_register_message (app, "open-url", "Opens a new URL in the browser."
" Parameters: url(string), open-in-new-window(boolean)",
closure, G_TYPE_NONE, G_TYPE_STRING, G_TYPE_BOOLEAN, G_TYPE_NONE);
Function accepting variable number of arguments
static GValue *
message_open_url_cb (BonoboApplication *app, const char *message, GValueArray *args)
{
const char *url;
gboolean new_win = TRUE;
g_return_val_if_fail (strcmp (message, "open-url") == 0, NULL);
g_return_val_if_fail (args->n_values > 0, NULL);
g_return_val_if_fail (G_VALUE_HOLDS_STRING (&args->values[0]), NULL);
url = g_value_get_string (&args->values[0]);
if (args->n_values > 1)
{
g_return_val_if_fail (G_VALUE_HOLDS_BOOLEAN (&args->values[1]), NULL);
new_win = g_value_get_boolean (&args->values[1]);
}
...
return NULL;
}
...
bonobo_application_register_message (app, "open-url", "Opens a new URL in the browser."
" Parameters: url(string) [, open-in-new-window(boolean)]",
NULL, G_TYPE_NONE, G_TYPE_STRING, G_TYPE_BOOLEAN, G_TYPE_NONE);
g_signal_connect (app, "message::open-url", G_CALLBACK (message_open_url_cb), NULL);
You are not required to register any messages for your application.
However, only registered functions are included in the list returned by
bonobo_app_client_msg_list()
@app:
@name:
@description:
@opt_closure:
@return_type:
@first_arg_type:
@Varargs:
@app:
@name:
@description:
@opt_closure:
@return_type:
@app:
@name:
@description:
@opt_closure:
@return_type:
@first_arg_type:
@var_args:
@app:
@argc:
@argv:
@Returns:
@app:
@envp:
@Returns:
@app:
@serverinfo:
@client:
@Returns:
@func:
@data:
@func:
@data: