方法
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_link
和 value
设置为刚刚推进到的链接的名称和 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
。方法的调用者将拥有返回的数据,并负责释放它。