虚函数

Gio动作组activate_action

since: 2.28

声明 [src]

void
activate_action (
  GActionGroup* action_group,
  const gchar* action_name,
  GVariant* parameter
)

描述 [src]

激活 action_group 中的指定动作。

如果动作需要参数，那么必须在 parameter 中给定正确的参数类型。如果动作不需要参数，那么 parameter 必须是 NULL。请参阅 g_action_group_get_action_parameter_type()。

如果 GActionGroup 的实现支持通过 D-Bus 异步远程激活，则此调用可能在相关的 D-Bus 流量发送之前返回，或者在没有收到任何回复的情况下返回。为了在异步激活调用上阻塞，应在依赖于动作激活结果代码之前调用 g_dbus_connection_flush()。如果不刷新 D-Bus 连接，则无法保证动作将被激活。

以下在远程应用实例中运行的代码，展示了在主应用实例上通过 D-Bus 激活“退出”动作的示例。在此例中，在 exit() 之前调用了 g_dbus_connection_flush()。如果不调用 g_dbus_connection_flush()，则在主实例上“退出”动作可能无法激活。

// call ‘quit’ action on primary instance
g_action_group_activate_action (G_ACTION_GROUP (app), "quit", NULL);

// make sure the action is activated now
g_dbus_connection_flush (…);

g_debug ("Application has been terminated. Exiting.");

exit (0);

since: 2.28

参数

action_name

类型： const gchar*

要激活的动作的名称。

数据由方法的调用者拥有。

值是 NUL 结尾的 UTF-8 字符串。

parameter

类型： GVariant

激活的参数。

参数可以是 NULL。

数据由方法的调用者拥有。