gio/org.gtkkn.bindings.gio/Menu

Menu

open class Menu(pointer: <Error class: unknown class><<Error class: unknown class>>) : MenuModel

GMenu is a simple implementation of class@Gio.MenuModel. You populate a GMenu by adding class@Gio.MenuItem instances to it.

There are some convenience functions to allow you to directly add items (avoiding class@Gio.MenuItem) for the common cases. To add a regular item, use method@Gio.Menu.insert. To add a section, use method@Gio.Menu.insert_section. To add a submenu, use method@Gio.Menu.insert_submenu.

Since

2.32

Constructors

constructor()

Creates a new #GMenu.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

object Companion

Properties

gioMenuModelPointer

val gioMenuModelPointer: <Error class: unknown class><<Error class: unknown class>>

val gioMenuPointer: <Error class: unknown class><<Error class: unknown class>>

Functions

open fun append(label: String? = null, detailedAction: String? = null)

Convenience function for appending a normal menu item to the end of

open fun appendItem(item: MenuItem)

Appends @item to the end of @menu.

open fun appendSection(label: String? = null, section: MenuModel)

Convenience function for appending a section menu item to the end of

open fun appendSubmenu(label: String? = null, submenu: MenuModel)

Convenience function for appending a submenu menu item to the end of

connectItemsChanged

fun connectItemsChanged(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: (position: Int, removed: Int, added: Int) -> Unit): <Error class: unknown class>

Emitted when a change has occurred to the menu.

open fun freeze()

Marks @menu as frozen.

getItemAttributeValue

open fun getItemAttributeValue(itemIndex: Int, attribute: String, expectedType: <Error class: unknown class>? = null): <Error class: unknown class>?

Queries the item at position @item_index in @model for the attribute specified by @attribute.

open fun getItemLink(itemIndex: Int, link: String): MenuModel?

Queries the item at position @item_index in @model for the link specified by @link.

open fun getNItems(): Int

Query the number of items in @model.

open fun insert(position: Int, label: String? = null, detailedAction: String? = null)

Convenience function for inserting a normal menu item into @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative.

open fun insertItem(position: Int, item: MenuItem)

Inserts @item into @menu.

open fun insertSection(position: Int, label: String? = null, section: MenuModel)

Convenience function for inserting a section menu item into @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative.

open fun insertSubmenu(position: Int, label: String? = null, submenu: MenuModel)

Convenience function for inserting a submenu menu item into @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative.

open fun isMutable(): Boolean

Queries if @model is mutable.

open fun itemsChanged(position: Int, removed: Int, added: Int)

Requests emission of the #GMenuModel::items-changed signal on @model.

iterateItemAttributes

open fun iterateItemAttributes(itemIndex: Int): MenuAttributeIter

Creates a #GMenuAttributeIter to iterate over the attributes of the item at position @item_index in @model.

iterateItemLinks

open fun iterateItemLinks(itemIndex: Int): MenuLinkIter

Creates a #GMenuLinkIter to iterate over the links of the item at position @item_index in @model.

open fun prepend(label: String? = null, detailedAction: String? = null)

Convenience function for prepending a normal menu item to the start of @menu. Combine g_menu_item_new() and g_menu_insert_item() for a more flexible alternative.

open fun prependItem(item: MenuItem)

Prepends @item to the start of @menu.

open fun prependSection(label: String? = null, section: MenuModel)

Convenience function for prepending a section menu item to the start of @menu. Combine g_menu_item_new_section() and g_menu_insert_item() for a more flexible alternative.

open fun prependSubmenu(label: String? = null, submenu: MenuModel)

Convenience function for prepending a submenu menu item to the start of @menu. Combine g_menu_item_new_submenu() and g_menu_insert_item() for a more flexible alternative.

open fun remove(position: Int)

Removes an item from the menu.

open fun removeAll()

Removes all items in the menu.