BonoboAppHookFunc ()

void                (*BonoboAppHookFunc)                (BonoboApplication *app,
                                                         gpointer data);

bonobo_application_new ()

BonoboApplication *         bonobo_application_new      (const char *name);

Creates a new BonoboApplication object.

bonobo_application_register_message ()

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.

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.

1
2
3
4
5
6
7
8
9
10
11

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);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

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);

bonobo_application_register_message_v ()

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().

bonobo_application_register_message_va ()

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().

bonobo_application_new_instance ()

gint                bonobo_application_new_instance     (BonoboApplication *app,
                                                         gint argc,
                                                         gchar *argv[]);

Emit the "new-instance" signal of the BonoboApplication with the given arguments.

bonobo_application_create_serverinfo ()

gchar *                    bonobo_application_create_serverinfo
                                                        (BonoboApplication *app,
                                                         gchar const *envp[]);

This utility function provides a simple way to contruct a valid serverinfo XML string.

bonobo_application_register_unique ()

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.

bonobo_application_add_hook ()

void                bonobo_application_add_hook         (BonoboAppHookFunc func,
                                                         gpointer data);

Add a hook function to be called whenever a new BonoboApplication instance is created.

bonobo_application_remove_hook ()

void                bonobo_application_remove_hook      (BonoboAppHookFunc func,
                                                         gpointer data);

Removes a hook function previously set with bonobo_application_add_hook().