Libbonobo Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
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
,...
);
Details
BonoboAppClientMsgDesc
typedef struct { gchar *name; GType return_type; GType *types; /* G_TYPE_NONE-terminated array */ gchar *description; } BonoboAppClientMsgDesc;
bonobo_app_client_new ()
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.
Warning
Applications should not use this function. Seebonobo_application_register_unique()
.
|
|
Returns : |
a BonoboAppClient object. |
bonobo_app_client_new_instance ()
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 |
bonobo_app_client_msg_send_valist ()
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 |
bonobo_app_client_msg_send_argv ()
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 |
bonobo_app_client_msg_send ()
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. |