虚方法
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
。方法的调用者拥有返回数据的所有权,并负责释放它。