* See g_menu_insert(), g_menu_insert_section() and
* g_menu_insert_submenu() as well as "prepend" and "append" variants of
* each of these functions.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_item (GMenu *menu,
gint position,
* Prepends @item to the start of @menu.
*
* See g_menu_insert_item() for more information.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_item (GMenu *menu,
GMenuItem *item)
* Appends @item to the end of @menu.
*
* See g_menu_insert_item() for more information.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_item (GMenu *menu,
GMenuItem *item)
*
* This function causes g_menu_model_is_mutable() to begin returning
* %FALSE, which has some positive performance implications.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_freeze (GMenu *menu)
{
* The new menu has no items.
*
* Returns: a new #GMenu
- **/
+ *
+ * Since: 2.32
+ */
GMenu *
g_menu_new (void)
{
* Convenience function for inserting a normal menu item into @menu.
* Combine g_menu_new() and g_menu_insert_item() for a more flexible
* alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert (GMenu *menu,
gint position,
* Convenience function for prepending a normal menu item to the start
* of @menu. Combine g_menu_new() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend (GMenu *menu,
const gchar *label,
* Convenience function for appending a normal menu item to the end of
* @menu. Combine g_menu_new() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append (GMenu *menu,
const gchar *label,
* Convenience function for inserting a section menu item into @menu.
* Combine g_menu_new_section() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_section (GMenu *menu,
gint position,
* Convenience function for prepending a section menu item to the start
* of @menu. Combine g_menu_new_section() and g_menu_insert_item() for
* a more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_section (GMenu *menu,
const gchar *label,
* Convenience function for appending a section menu item to the end of
* @menu. Combine g_menu_new_section() and g_menu_insert_item() for a
* more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_section (GMenu *menu,
const gchar *label,
* Convenience function for inserting a submenu menu item into @menu.
* Combine g_menu_new_submenu() and g_menu_insert_item() for a more
* flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_insert_submenu (GMenu *menu,
gint position,
* Convenience function for prepending a submenu menu item to the start
* of @menu. Combine g_menu_new_submenu() and g_menu_insert_item() for
* a more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_prepend_submenu (GMenu *menu,
const gchar *label,
* Convenience function for appending a submenu menu item to the end of
* @menu. Combine g_menu_new_submenu() and g_menu_insert_item() for a
* more flexible alternative.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_append_submenu (GMenu *menu,
const gchar *label,
* It is not possible to remove items by identity since items are added
* to the menu simply by copying their links and attributes (ie:
* identity of the item itself is not preserved).
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_remove (GMenu *menu,
gint position)
*
* See also g_menu_item_set_attribute() for a more convenient way to do
* the same.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_attribute_value (GMenuItem *menu_item,
const gchar *attribute,
*
* See also g_menu_item_set_attribute_value() for an equivalent call
* that directly accepts a #GVariant.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_attribute (GMenuItem *menu_item,
const gchar *attribute,
* Link types are restricted to lowercase characters, numbers
* and '-'. Furthermore, the names must begin with a lowercase character,
* must not end with a '-', and must not contain consecutive dashes.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_link (GMenuItem *menu_item,
*
* If @label is non-%NULL it is used as the label for the menu item. If
* it is %NULL then the label attribute is unset.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_label (GMenuItem *menu_item,
const gchar *label)
*
* The effect of having one menu appear as a submenu of another is
* exactly as it sounds.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_submenu (GMenuItem *menu_item,
GMenuModel *submenu)
* the menu that @menu_item is added to. See g_menu_item_new_section()
* for more information about what it means for a menu item to be a
* section.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_section (GMenuItem *menu_item,
GMenuModel *section)
* See g_menu_item_set_action_and_target() or
* g_menu_item_set_detailed_action() for two equivalent calls that are
* probably more convenient for most uses.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_action_and_target_value (GMenuItem *menu_item,
*
* See also g_menu_item_set_action_and_target_value() for a
* description of the semantics of the action and target attributes.
+ *
+ * Since: 2.32
*/
void
g_menu_item_set_action_and_target (GMenuItem *menu_item,
*
* See also g_menu_set_action_and_target_value() for a description of
* the semantics of the action and target attributes.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_item_set_detailed_action (GMenuItem *menu_item,
const gchar *detailed_action)
* g_menu_item_set_detailed_action() for more information.
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new (const gchar *label,
const gchar *detailed_action)
* g_menu_item_set_submenu().
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new_submenu (const gchar *label,
GMenuModel *submenu)
* ]]></programlisting></informalexample>
*
* Returns: a new #GMenuItem
- **/
+ *
+ * Since: 2.32
+ */
GMenuItem *
g_menu_item_new_section (const gchar *label,
GMenuModel *section)
* signal. Consumers of the model may make optimisations accordingly.
*
* Returns: %TRUE if the model is mutable (ie: "items-changed" may be
- * emitted).
- **/
+ * emitted).
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_model_is_mutable (GMenuModel *model)
{
* Query the number of items in @model.
*
* Returns: the number of items
- **/
+ *
+ * Since: 2.32
+ */
gint
g_menu_model_get_n_items (GMenuModel *model)
{
* You must free the iterator with g_object_unref() when you are done.
*
* Returns: (transfer full): a new #GMenuAttributeIter
+ *
+ * Since: 2.32
*/
GMenuAttributeIter *
g_menu_model_iterate_item_attributes (GMenuModel *model,
* then %NULL is returned.
*
* Returns: (transfer full): the value of the attribute
- **/
+ *
+ * Since: 2.32
+ */
GVariant *
g_menu_model_get_item_attribute_value (GMenuModel *model,
gint item_index,
* returned.
*
* Returns: %TRUE if the named attribute was found with the expected
- * type
- **/
+ * type
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_model_get_item_attribute (GMenuModel *model,
gint item_index,
* You must free the iterator with g_object_unref() when you are done.
*
* Returns: (transfer full): a new #GMenuLinkIter
- **/
+ *
+ * Since: 2.32
+ */
GMenuLinkIter *
g_menu_model_iterate_item_links (GMenuModel *model,
gint item_index)
* does not exist, %NULL is returned.
*
* Returns: (transfer full): the linked #GMenuModel, or %NULL
- **/
+ *
+ * Since: 2.32
+ */
GMenuModel *
g_menu_model_get_item_link (GMenuModel *model,
gint item_index,
* entry and not in response to calls -- particularly those from the
* #GMenuModel API. Said another way: the menu must not change while
* user code is running without returning to the mainloop.
- **/
+ *
+ * Since: 2.32
+ */
void
g_menu_model_items_changed (GMenuModel *model,
gint position,
* be unreffed using g_variant_unref() when it is no longer in use.
*
* Returns: %TRUE on success, or %FALSE if there is no additional
- * attribute
- **/
+ * attribute
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_attribute_iter_get_next (GMenuAttributeIter *iter,
const gchar **out_name,
* attribute exists at all).
*
* Returns: %TRUE on success, or %FALSE when there are no more attributes
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_attribute_iter_next (GMenuAttributeIter *iter)
{
* The iterator is not advanced.
*
* Returns: the name of the attribute
- **/
+ *
+ * Since: 2.32
+ */
const gchar *
g_menu_attribute_iter_get_name (GMenuAttributeIter *iter)
{
* The iterator is not advanced.
*
* Returns: (transfer full): the value of the current attribute
- **/
+ *
+ * Since: 2.32
+ */
GVariant *
g_menu_attribute_iter_get_value (GMenuAttributeIter *iter)
{
* be unreffed using g_object_unref() when it is no longer in use.
*
* Returns: %TRUE on success, or %FALSE if there is no additional link
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_link_iter_get_next (GMenuLinkIter *iter,
const gchar **out_link,
* at all).
*
* Returns: %TRUE on success, or %FALSE when there are no more links
- **/
+ *
+ * Since: 2.32
+ */
gboolean
g_menu_link_iter_next (GMenuLinkIter *iter)
{
* The iterator is not advanced.
*
* Returns: the type of the link
- **/
+ *
+ * Since: 2.32
+ */
const gchar *
g_menu_link_iter_get_name (GMenuLinkIter *iter)
{
* The iterator is not advanced.
*
* Returns: (transfer full): the #GMenuModel that is linked to
- **/
+ *
+ * Since: 2.32
+ */
GMenuModel *
g_menu_link_iter_get_value (GMenuLinkIter *iter)
{