Amtk.ApplicationWindow¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`create_open_recent_menu_base` ()
class	`get_from_gtk_application_window` (gtk_window)
	`connect_menu_to_statusbar` (menu_shell)
	`connect_recent_chooser_menu_to_statusbar` (menu)
	`create_open_recent_menu` ()
	`create_open_recent_menu_item` ()
	`get_application_window` ()
	`get_statusbar` ()
	`set_statusbar` (statusbar)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Name	Type	Flags	Short Description
`application-window`	`Gtk.ApplicationWindow`	r/w/co
`statusbar`	`Gtk.Statusbar`	r/w

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GObject.Object`	r

Class Details¶

class Amtk.ApplicationWindow(**kwargs)¶

Bases:: GObject.Object
Abstract:: No
Structure:: Amtk.ApplicationWindowClass

classmethod create_open_recent_menu_base()¶

Returns:: a new Gtk.RecentChooserMenu.
Return type:: Gtk.RecentChooserMenu

Creates the base of a simple and generic Gtk.RecentChooserMenu.

The Gtk.RecentChooser is configured to show files only recently used with the current application, as returned by GLib.get_application_name(). If recent files are added to the default Gtk.RecentManager with Gtk.RecentManager.add_item(), the files will normally show up in the Gtk.RecentChooserMenu.

New in version 5.6.

classmethod get_from_gtk_application_window(gtk_window)¶

Parameters:: gtk_window (Gtk.ApplicationWindow) – a Gtk.ApplicationWindow.
Returns:: the Amtk.ApplicationWindow of gtk_window.
Return type:: Amtk.ApplicationWindow

Returns the Amtk.ApplicationWindow of gtk_window. The returned object is guaranteed to be the same for the lifetime of gtk_window.

New in version 2.0.

connect_menu_to_statusbar(menu_shell)¶

Parameters:: menu_shell (Gtk.MenuShell) – a Gtk.MenuShell.

Connects to the Amtk.MenuShell ::menu-item-selected and Amtk.MenuShell ::menu-item-deselected signals of menu_shell to push/pop the long description of Gtk.MenuItem's to the Amtk.ApplicationWindow :statusbar.

The long description is retrieved with Amtk.menu_item_get_long_description(). So Amtk.menu_item_set_long_description() must have been called, which is the case if the Gtk.MenuItem has been created with Amtk.Factory.

New in version 2.0.

connect_recent_chooser_menu_to_statusbar(menu)¶

Parameters:: menu (Gtk.RecentChooserMenu) – a Gtk.RecentChooserMenu.

An alternative to Gtk.RecentChooser.set_show_tips(). Shows the full path in the Amtk.ApplicationWindow :statusbar when a Gtk.MenuItem of menu is selected.

The full path is retrieved with Amtk.utils_recent_chooser_menu_get_item_uri().

New in version 2.0.

create_open_recent_menu()¶

Returns:: a new Gtk.RecentChooserMenu.
Return type:: Gtk.Widget

This function creates a Gtk.RecentChooserMenu with Amtk.ApplicationWindow.create_open_recent_menu_base(), and setup these additional things:

The Gtk.RecentChooserMenu is connected to the statusbar with Amtk.ApplicationWindow.connect_recent_chooser_menu_to_statusbar().
When the Gtk.RecentChooser ::item-activated signal is emitted, Gio.Application.open() is called (with an empty hint), so the Gio.Application must have the Gio.ApplicationFlags.HANDLES_OPEN flag set.

New in version 3.0.

create_open_recent_menu_item()¶

Returns:: a new Gtk.MenuItem.
Return type:: Gtk.Widget

Creates a Gtk.MenuItem with a simple and generic Gtk.RecentChooserMenu as submenu. The Gtk.RecentChooserMenu is created with Amtk.ApplicationWindow.create_open_recent_menu().

New in version 2.0.

get_application_window()¶

Returns:: the Gtk.ApplicationWindow of self.
Return type:: Gtk.ApplicationWindow

New in version 2.0.

get_statusbar()¶

Returns:: the Amtk.ApplicationWindow :statusbar.
Return type:: Gtk.Statusbar or None

New in version 2.0.

set_statusbar(statusbar)¶

Parameters:: statusbar (Gtk.Statusbar or None) – a Gtk.Statusbar, or None.

Sets the Amtk.ApplicationWindow :statusbar property.

New in version 2.0.

Property Details¶

Amtk.ApplicationWindow.props.application_window¶

Name:: application-window
Type:: Gtk.ApplicationWindow
Default Value:: None
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

The Gtk.ApplicationWindow.

New in version 2.0.

Amtk.ApplicationWindow.props.statusbar¶

Name:: statusbar
Type:: Gtk.Statusbar
Default Value:: None
Flags:: READABLE, WRITABLE

The Gtk.Statusbar. None by default.

New in version 2.0.