函数

GioDBusActionGroupget

自:2.32

声明 [源代码]

GDBusActionGroup*
g_dbus_action_group_get (
  GDBusConnection* connection,
  const gchar* bus_name,
  const gchar* object_path
)

描述 [源代码]

通过给定 bus_nameobject_path 导出的操作组,获取一个 GDBusActionGroup

此调用时采用线程默认的主上下文。所有菜单模型(及其任何关联的模型)上的信号都是相对于此上下文报告的。返回的菜单模型(及其关联的模型)上的所有调用也必须来源于此相同的上下文,且线程默认主上下文保持不变。

此调用是非阻塞的。返回的操作组可能已经被填充或尚未填充。正确的方法是将操作组的信号连接起来以监控更改,然后调用 g_action_group_list_actions() 获取初始列表。

自:2.32

参数

connection

类型: GDBusConnection

一个 GDBusConnection

这些数据由函数的调用者拥有。
bus_name

类型: const gchar*

导出操作组的总线名称或NULL,如果 connection 不是消息总线连接。

该参数可以是 NULL
这些数据由函数的调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。
object_path

类型: const gchar*

操作组导出的对象路径。

这些数据由函数的调用者拥有。
该值是一个以空字符终止的 UTF-8 字符串。

返回值

类型: GDBusActionGroup

一个 GDBusActionGroup

函数的调用者将获取数据的所有权,并负责释放它。