方法

GioMenuLinkIterget_next

since: 2.32

声明 [src]

gboolean
g_menu_link_iter_get_next (
  GMenuLinkIter* iter,
  const gchar** out_link,
  GMenuModel** value
)

描述 [src]

此函数结合了 g_menu_link_iter_next()g_menu_link_iter_get_name() 和 g_menu_link_iter_get_value()。

首先将迭代器向前推进到下一个(可能是第一个)链接。如果失败,则返回 FALSE,且没有其他效果。

如果成功,则将 out_linkvalue 设置为刚刚推进到的链接的名称和 GMenuModel。在此点,g_menu_link_iter_get_name()g_menu_link_iter_get_value() 将再次返回相同的值。

out_link 中返回的值直到迭代器保持在当前位置时有效。在 value 中返回的值不再使用时,必须使用 g_object_unref() 释放它。

since: 2.32

参数

out_link

类型: const gchar**

链接的名称。

该参数将由函数设置。
该参数可以是 NULL
返回的数据由实例拥有。
该值是空终止的 UTF-8 字符串。
value

类型: GMenuModel

链接的 GMenuModel

该参数将由函数设置。
该参数可以是 NULL
方法的调用者将拥有返回的数据,并负责释放它。

返回值

类型: gboolean

TRUE 成功,或者如果不存在额外的链接,则返回 FALSE