|  |  |  | 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:
| 1 2 3 4 5 | 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. |