函数
GioDBusActionGroupget
自:2.32
声明 [源代码]
GDBusActionGroup*
g_dbus_action_group_get (
GDBusConnection* connection,
const gchar* bus_name,
const gchar* object_path
)
描述 [源代码]
通过给定 bus_name
和 object_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
。
函数的调用者将获取数据的所有权,并负责释放它。 |