![]() | ![]() | ![]() | Libbonobo Reference Manual | ![]() |
---|
bonobo-app-clientbonobo-app-client — client interface to remote BonoboApplication objects |
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()
.
app_server : | |
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.
app_client : | a BonoboAppClient |
argc : | length of argv
|
argv : | array of command-line arguments |
opt_env : | 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()
.
app_client : | client |
message : | message name |
opt_env : | optional corba environment |
first_arg_type : | first message parameter |
var_args : | 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.
app_client : | client |
message : | message name |
argv : | NULL -terminated vector of pointers to GValue, the arguments
to pass with the message.
|
opt_env : | |
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);
app_client : | the client interface associated with the application to which we wish to send a message |
message : | message name |
opt_env : | |
first_arg_type : | |
... : | arguments |
Returns : | a GValue containing the value returned from the aplication server. |
<< bonobo-application | Objects, Factories, Reference Counting >> |