方法

GioMenuModelget_item_attribute

始于:2.32

声明 [源代码位置]

gboolean
g_menu_model_get_item_attribute (
  GMenuModel* model,
  gint item_index,
  const gchar* attribute,
  const gchar* format_string,
  ...
)

描述 [源代码位置]

查询在model中位置为item_index的项的,由attribute指定的属性。

如果属性存在并匹配与format_string对应的GVariantType,则使用format_string将值分解为位置参数,并返回TRUE。

如果属性不存在或存在但类型不正确,则忽略位置参数并返回FALSE。

此函数是g_menu_model_get_item_attribute_value()和g_variant_get()的混合,后跟一个g_variant_unref()。因此,format_string必须对数据进行完整的副本(因为在调用g_variant_unref()之后,GVariant可能会消失)。特别是,在format_string中不允许使用'&'字符。

始于:2.32

此方法不直接适用于语言绑定。

参数

item_index

类型: gint

项目的索引。

attribute

类型: const gchar*

要查询的属性。

数据由方法的调用者拥有。
值是一个以NUL结尾的UTF-8字符串。
format_string

类型: const gchar*

GVariant格式字符串。

数据由方法的调用者拥有。
值是一个以NUL结尾的UTF-8字符串。
...

类型:

位置参数,如format_string中所述。

返回值

类型: gboolean

如果找到具有预期类型的命名词段属性,则为TRUE