|  |  |  | Libbonobo Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
                    BonoboAppClientMsgDesc;
BonoboAppClient*    bonobo_app_client_new               (Bonobo_Application app_server);
gint                bonobo_app_client_new_instance      (BonoboAppClient *app_client,
                                                         int argc,
                                                         char *argv[],
                                                         CORBA_Environment *opt_env);
GValue*             bonobo_app_client_msg_send_valist   (BonoboAppClient *app_client,
                                                         const char *message,
                                                         CORBA_Environment *opt_env,
                                                         GType first_arg_type,
                                                         va_list var_args);
GValue *            bonobo_app_client_msg_send_argv     (BonoboAppClient *app_client,
                                                         const char *message,
                                                         const GValue *argv[],
                                                         CORBA_Environment *opt_env);
GValue*             bonobo_app_client_msg_send          (BonoboAppClient *app_client,
                                                         const char *message,
                                                         CORBA_Environment *opt_env,
                                                         GType first_arg_type,
                                                         ...);
typedef struct {
	gchar *name;
	GType  return_type;
	GType *types;		/* G_TYPE_NONE-terminated array */
	gchar *description;
} BonoboAppClientMsgDesc;
BonoboAppClient* bonobo_app_client_new (Bonobo_Application app_server);
app_server: object reference to a Bonobo::Application; this
function takes ownership of this reference (use
bonobo_object_dup_ref() if you want to keep your own reference.)
Create an application client object connected to the remote (or local) Bonobo::Application object.
bonobo_application_register_unique().
| 
 | |
| Returns : | a BonoboAppClient object. | 
gint bonobo_app_client_new_instance (BonoboAppClient *app_client, int argc, char *argv[], CORBA_Environment *opt_env);
Ask the application server to emit a "new-instance" signal containing the specified string vector.
| 
 | a BonoboAppClient | 
| 
 | length of argv | 
| 
 | array of command-line arguments | 
| 
 | a CORBA_Environment, or NULL. | 
| Returns : | the message return value | 
GValue* bonobo_app_client_msg_send_valist (BonoboAppClient *app_client, const char *message, CORBA_Environment *opt_env, GType first_arg_type, va_list var_args);
See bonobo_app_client_msg_send().
| 
 | client | 
| 
 | message name | 
| 
 | optional corba environment | 
| 
 | first message parameter | 
| 
 | remaining parameters | 
| Returns : | return value | 
GValue * bonobo_app_client_msg_send_argv (BonoboAppClient *app_client, const char *message, const GValue *argv[], CORBA_Environment *opt_env);
Like bonobo_app_client_msg_send(), except that it receives a single
argument vector instead of a variable number of arguments.
| 
 | client | 
| 
 | message name | 
| 
 | NULL-terminated vector of pointers to GValue, the arguments
to pass with the message. | 
| 
 | |
| Returns : | the message return value | 
GValue* bonobo_app_client_msg_send (BonoboAppClient *app_client, const char *message, CORBA_Environment *opt_env, GType first_arg_type, ...);
Send a message to the application server. Takes a variable length
argument list of GType, value pairs, terminated with
G_TYPE_NONE. Values are direct C values, not GValues! Example:
GValue *retval;
retval = bonobo_app_client_msg_send (app_client, "openURL",
                                     G_TYPE_STRING, "http://www.gnome.org",
                                     G_TYPE_BOOLEAN, TRUE,
                                     G_TYPE_NONE);
| 
 | the client interface associated with the application to which we wish to send a message | 
| 
 | message name | 
| 
 | |
| 
 | |
| 
 | arguments | 
| Returns : | a GValue containing the value returned from the aplication server. |