虚方法

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,并且没有其他影响。

如果成功,将namevalue设置为刚移动到的属性的名称和值。在此点,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
方法的调用者拥有返回数据的所有权,并负责释放它。

返回值

类型: gboolean

在成功时返回TRUE,或者在没有任何其他属性时返回FALSE