Overrides

Overrides

Some properties, methods, and attributes of GObject.Objects are overridden to make declarative UI construction easier and reduce boilerplate.

Gio.Menu and Gio.MenuItem

local button = Gtk.MenuButton()
local menu = Gio.Menu()

local item = Gio.MenuItem()
item:set_label('option 1')
item:set_detailed_action('action()')

local submenu = Gio.Menu()

local submenu_item = Gio.MenuItem()
submenu_item:set_label('submenu')
submenu_item:set_submenu(submenu)

menu:append_item(item)
menu:append_item(submenu_item)
button:set_menu_model(menu)

local menubutton = MenuButton {
    Gio.Menu {
        Gio.MenuItem { label = 'option 1', action = 'action()' },
        Gio.MenuItem {
            label = 'submenu',

            -- Shorthand for:
            -- submenu = Gio.Menu { ... }
            Gio.Menu {},
        },
    },
}

GLib.Variant

A convenience :decode() method is provided for converting a GLib.Variant into native Lua values.

local variant = GLib.Variant(
    '(a{o(oayays)})',
    {
        {
            ['/path/to/object1'] = {
                '/path/to/object2',
                'bytestring1',
                'bytestring2',
                'string',
            },
        },
    }
)

local bytestring2 = tuple
    :get_child_value(0)
    :get_child_value(0)
    :get_child_value(1)
    :get_child_value(2).value

local bytestring2 = tuple:decode()[1]['/path/to/object1'][3]