| Top | |
|
|
|
| void | pluma_message_get () |
| void | pluma_message_get_valist () |
| void | pluma_message_get_value () |
| void | pluma_message_set () |
| void | pluma_message_set_valist () |
| void | pluma_message_set_value () |
| void | pluma_message_set_valuesv () |
| const gchar * | pluma_message_get_object_path () |
| const gchar * | pluma_message_get_method () |
| gboolean | pluma_message_has_key () |
| GType | pluma_message_get_key_type () |
| gboolean | pluma_message_validate () |
| gchar * | method | Read |
| gchar * | object-path | Read |
| PlumaMessageType * | type | Read / Write / Construct Only |
Communication on a PlumaMessageBus is done through messages. Messages are sent over the bus and received by connecting callbacks on the message bus. A PlumaMessage is an instantiation of a PlumaMessageType, containing values for the arguments as specified in the message type.
A message can be seen as a method call, or signal emission depending on who is the sender and who is the receiver. There is no explicit distinction between methods and signals.
void pluma_message_get (PlumaMessage *message,...);
Get values of message arguments. The supplied var_args
should contain
pairs of keys and pointers to variables which are set to the argument
value for the specified key.
void pluma_message_get_valist (PlumaMessage *message,va_list var_args);
Get values of message arguments. The supplied var_args
should contain
pairs of keys and pointers to variables which are set to the argument
value for the specified key.
message |
the PlumaMessage |
|
var_args |
a NULL variable argument list of key/value container pairs |
void pluma_message_get_value (PlumaMessage *message,const gchar *key,GValue *value);
Get the value of a specific message argument. value
will be initialized
with the correct type.
void pluma_message_set (PlumaMessage *message,...);
Set values of message arguments. The supplied var_args
should contain
pairs of keys and argument values.
void pluma_message_set_valist (PlumaMessage *message,va_list var_args);
Set values of message arguments. The supplied var_args
should contain
pairs of keys and argument values.
void pluma_message_set_value (PlumaMessage *message,const gchar *key,GValue *value);
Set value of message argument key
to value
.
void pluma_message_set_valuesv (PlumaMessage *message,const gchar **keys,GValue *values,gint n_values);
Set message argument values.
message |
the PlumaMessage |
|
keys |
keys to set values for |
|
values |
values to set |
|
n_values |
number of arguments to set values for |
const gchar *
pluma_message_get_object_path (PlumaMessage *message);
Get the message object path.
const gchar *
pluma_message_get_method (PlumaMessage *message);
Get the message method.
gboolean pluma_message_has_key (PlumaMessage *message,const gchar *key);
Check whether the message has a specific key.
GType pluma_message_get_key_type (PlumaMessage *message,const gchar *key);
Get the type of a message argument.
gboolean
pluma_message_validate (PlumaMessage *message);
Validates the message arguments according to the message type.
“object-path” property“object-path” gchar *
The message object path.
Flags: Read
Default value: NULL
“type” property“type” PlumaMessageType *
The message type.
Flags: Read / Write / Construct Only