虚方法
GioMenuAttributeIterget_next
自2.32以来
声明 [src]
gboolean
get_next (
GMenuAttributeIter* iter,
const gchar** out_name,
GVariant** value
)
描述 [src]
此函数结合了g_menu_attribute_iter_next()、g_menu_attribute_iter_get_name()和g_menu_attribute_iter_get_value()。
首先将迭代器向前移动到下一个(可能是第一个)属性。如果失败,则返回FALSE,并且没有其他影响。
如果成功,将name和value设置为刚移动到的属性的名称和值。在此点,g_menu_attribute_iter_get_name()和g_menu_attribute_iter_get_value()将再次返回相同的值。
在name中返回的值在迭代器保持在当前位置时保持有效。在value中返回的值,当不再使用时,必须使用g_variant_unref()进行解除引用。
自2.32以来可用
参数
out_name-
类型:
const gchar**属性的类型。
该参数将由函数设置。 该参数可以是 NULL。返回的数据由实例拥有。 值是一个以NUL结尾的UTF-8字符串。 value-
类型:
GVariant属性的值。
该参数将由函数设置。 该参数可以是 NULL。方法的调用者拥有返回数据的所有权,并负责释放它。