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 |
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. |
[array length=n_values] |
values |
values to set. |
[array length=n_values] |
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.
“method”
property “method” gchar *
The messages method.
Owner: PlumaMessage
Flags: Read
Default value: NULL
“object-path”
property “object-path” gchar *
The message object path.
Owner: PlumaMessage
Flags: Read
Default value: NULL
“type”
property“type” PlumaMessageType *
The message type.
Owner: PlumaMessage
Flags: Read / Write / Construct Only