方法

gioDBusConnectionexport_menu_model

自 2.32 开始

声明 [源]

guint
g_dbus_connection_export_menu_model (
  GDBusConnection* connection,
  const gchar* object_path,
  GMenuModel* menu,
  GError** error
)

描述 [源]

connectionobject_path 上导出 menu

实现的 D-Bus API 应考虑为私有。它在未来的更改中是受影响的。

一个对象路径只能导出一个菜单模型。如果违反此限制,导出将失败,并将返回 0(相应地设置 error)。

不支持导出包含超过 G_MENU_EXPORTER_MAX_SECTION_SIZE 项的节点的菜单,这会导致未定义的行为。

您可以使用 g_dbus_connection_unexport_menu_model() 使用此函数的返回值来未导出菜单模型。

自 2.32 开始可用

参数

object_path

类型: const gchar*

一个 D-Bus 对象路径。

此数据由方法调用者拥有。
该值是一个以NUL终止的UTF-8字符串。
菜单

类型: GMenuModel

一个GMenuModel

此数据由方法调用者拥有。
错误

类型: GError **

用于可恢复错误的返回位置。

该参数可以是NULL
如果返回位置不是NULL,则必须将其初始化为空的GError*
如果没有错误,方法将保留参数初始化为NULL
发生错误时,参数将被设置为一个新的GError,调用者将拥有数据所有权,并负责释放它。

返回值

类型: guint

导出的ID(从不为零),或在失败的情况下为0。