Method
GioMenuModelget_item_attribute
since: 2.32
Declaration
gboolean
g_menu_model_get_item_attribute (
GMenuModel* model,
gint item_index,
const gchar* attribute,
const gchar* format_string,
...
)
Description
Queries item at position item_index in model for the attribute
specified by attribute.
If the attribute exists and matches the GVariantType corresponding
to format_string then format_string is used to deconstruct the
value into the positional parameters and TRUE is returned.
If the attribute does not exist, or it does exist but has the wrong
type, then the positional parameters are ignored and FALSE is returned.
This function is a mix of g_menu_model_get_item_attribute_value() and
g_variant_get(), followed by a g_variant_unref(). As such,
format_string must make a complete copy of the data (since the
GVariant may go away after the call to g_variant_unref()). In
particular, no ‘&’ characters are allowed in format_string.
Available since: 2.32
This method is not directly available to language bindings.
Parameters
item_index-
Type:
gintThe index of the item.
attribute-
Type:
const gchar*The attribute to query.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. format_string-
Type:
const gchar*A
GVariantformat string.The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. ...-
Type:
Positional parameters, as per
format_string.