Class

AdwApplication

since: 1

Description [src]

class Adw.Application : Gtk.Application
  implements Gio.ActionGroup, Gio.ActionMap {
  /* No available fields */
}

A base class for Adwaita applications.

AdwApplication handles library initialization by calling adw_init() in the default GApplication::startup signal handler, in turn chaining up as required by GtkApplication. Therefore, any subclass of AdwApplication should always chain up its startup handler before using any Adwaita or GTK API.

Automatic Resources

AdwApplication will automatically load stylesheets located in the application’s resource base path (see g_application_set_resource_base_path(), if they’re present.

They can be used to add custom styles to the application, as follows:

  • style.css contains styles that are always present.

  • style-dark.css contains styles only used when AdwStyleManager:dark is TRUE.

  • style-hc.css contains styles used when the system high contrast preference is enabled.

  • style-hc-dark.css contains styles used when the system high contrast preference is enabled and AdwStyleManager:dark is TRUE.

Available since: 1

Constructors

adw_application_new

Creates a new AdwApplication.

since: 1

Instance methods

adw_application_get_style_manager

Gets the style manager for self.

since: 1

Methods inherited from GtkApplication (14)
gtk_application_add_window

Adds a window to application.

unstable since: 4.0

gtk_application_get_accels_for_action

Gets the accelerators that are currently associated with the given action.

unstable since: 4.0

gtk_application_get_actions_for_accel

Returns the list of actions (possibly empty) that accel maps to.

unstable since: 4.0

gtk_application_get_active_window

Gets the “active” window for the application.

unstable since: 4.0

gtk_application_get_menu_by_id

Gets a menu from automatically loaded resources.

unstable since: 4.0

gtk_application_get_menubar

Returns the menu model that has been set with gtk_application_set_menubar().

unstable since: 4.0

gtk_application_get_window_by_id

Returns the GtkApplicationWindow with the given ID.

unstable since: 4.0

gtk_application_get_windows

Gets a list of the GtkWindow instances associated with application.

unstable since: 4.0

gtk_application_inhibit

Inform the session manager that certain types of actions should be inhibited.

unstable since: 4.0

gtk_application_list_action_descriptions

Lists the detailed action names which have associated accelerators.

unstable since: 4.0

gtk_application_remove_window

Remove a window from application.

unstable since: 4.0

gtk_application_set_accels_for_action

Sets zero or more keyboard accelerators that will trigger the given action.

unstable since: 4.0

gtk_application_set_menubar

Sets or unsets the menubar for windows of application.

unstable since: 4.0

gtk_application_uninhibit

Removes an inhibitor that has been previously established.

unstable since: 4.0

Methods inherited from GApplication (36)

Please see GApplication for a full list of methods.

Methods inherited from GObject (43)

Please see GObject for a full list of methods.

Methods inherited from GActionGroup (14)
g_action_group_action_added

Emits the GActionGroup::action-added signal on action_group.

unstable since: 2.28

g_action_group_action_enabled_changed

Emits the GActionGroup::action-enabled-changed signal on action_group.

unstable since: 2.28

g_action_group_action_removed

Emits the GActionGroup::action-removed signal on action_group.

unstable since: 2.28

g_action_group_action_state_changed

Emits the GActionGroup::action-state-changed signal on action_group.

unstable since: 2.28

g_action_group_activate_action

Activate the named action within action_group.

unstable since: 2.28

g_action_group_change_action_state

Request for the state of the named action within action_group to be changed to value.

unstable since: 2.28

g_action_group_get_action_enabled

Checks if the named action within action_group is currently enabled.

unstable since: 2.28

g_action_group_get_action_parameter_type

Queries the type of the parameter that must be given when activating the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state

Queries the current state of the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state_hint

Requests a hint about the valid range of values for the state of the named action within action_group.

unstable since: 2.28

g_action_group_get_action_state_type

Queries the type of the state of the named action within action_group.

unstable since: 2.28

g_action_group_has_action

Checks if the named action exists within action_group.

unstable since: 2.28

g_action_group_list_actions

Lists the actions contained within action_group.

unstable since: 2.28

g_action_group_query_action

Queries all aspects of the named action within an action_group.

unstable since: 2.32

Methods inherited from GActionMap (5)
g_action_map_add_action

Adds an action to the action_map.

unstable since: 2.32

g_action_map_add_action_entries

A convenience function for creating multiple GSimpleAction instances and adding them to a GActionMap.

unstable since: 2.32

g_action_map_lookup_action

Looks up the action with the name action_name in action_map.

unstable since: 2.32

g_action_map_remove_action

Removes the named action from the action map.

unstable since: 2.32

g_action_map_remove_action_entries

Remove actions from a GActionMap. This is meant as the reverse of g_action_map_add_action_entries().

unstable since: 2.78

Properties

Adw.Application:style-manager

The style manager for this application.

since: 1

Properties inherited from GtkApplication (4)
Gtk.Application:active-window

The currently focused window of the application.

unstable since: 4.0

Gtk.Application:menubar

The GMenuModel to be used for the application’s menu bar.

unstable since: 4.0

Gtk.Application:register-session

Set this property to TRUE to register with the session manager.

unstable since: 4.0

Gtk.Application:screensaver-active

This property is TRUE if GTK believes that the screensaver is currently active.

unstable since: 4.0

Properties inherited from GApplication (9)
Gio.Application:action-group

The group of actions that the application exports.

unstable since: 2.28

Gio.Application:application-id

The unique identifier for the application.

unstable since: 2.28

Gio.Application:flags

Flags specifying the behaviour of the application.

unstable since: 2.28

Gio.Application:inactivity-timeout

Time (in milliseconds) to stay alive after becoming idle.

unstable since: 2.28

Gio.Application:is-busy

Whether the application is currently marked as busy through g_application_mark_busy() or g_application_bind_busy_property().

unstable since: 2.44

Gio.Application:is-registered

Whether g_application_register() has been called.

unstable since: 2.28

Gio.Application:is-remote

Whether this application instance is remote.

unstable since: 2.28

Gio.Application:resource-base-path

The base resource path for the application.

unstable since: 2.28

Gio.Application:version

The human-readable version number of the application.

unstable since: 2.80

Signals

Signals inherited from GtkApplication (3)
GtkApplication::query-end

Emitted when the session manager is about to end the session.

unstable since: 4.0

GtkApplication::window-added

Emitted when a GtkWindow is added to application through gtk_application_add_window().

unstable since: 4.0

GtkApplication::window-removed

Emitted when a GtkWindow is removed from application.

unstable since: 4.0

Signals inherited from GApplication (7)
GApplication::activate

The ::activate signal is emitted on the primary instance when an activation occurs. See g_application_activate().

unstable since: 2.0

GApplication::command-line

The ::command-line signal is emitted on the primary instance when a commandline is not handled locally. See g_application_run() and the GApplicationCommandLine documentation for more information.

unstable since: 2.0

GApplication::handle-local-options

The ::handle-local-options signal is emitted on the local instance after the parsing of the commandline options has occurred.

unstable since: 2.40

GApplication::name-lost

The ::name-lost signal is emitted only on the registered primary instance when a new instance has taken over. This can only happen if the application is using the G_APPLICATION_ALLOW_REPLACEMENT flag.

unstable since: 2.60

GApplication::open

The ::open signal is emitted on the primary instance when there are files to open. See g_application_open() for more information.

unstable since: 2.0

GApplication::shutdown

The ::shutdown signal is emitted only on the registered primary instance immediately after the main loop terminates.

unstable since: 2.0

GApplication::startup

The ::startup signal is emitted on the primary instance immediately after registration. See g_application_register().

unstable since: 2.0

Signals inherited from GObject (1)
GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

unstable since: 2.0

Signals inherited from GActionGroup (4)
GActionGroup::action-added

Signals that a new action was just added to the group. This signal is emitted after the action has been added and is now visible.

unstable since: 2.28

GActionGroup::action-enabled-changed

Signals that the enabled status of the named action has changed.

unstable since: 2.28

GActionGroup::action-removed

Signals that an action is just about to be removed from the group. This signal is emitted before the action is removed, so the action is still visible and can be queried from the signal handler.

unstable since: 2.28

GActionGroup::action-state-changed

Signals that the state of the named action has changed.

unstable since: 2.28

Class structure

struct AdwApplicationClass {
  GtkApplicationClass parent_class;
  
}
No description available.
Class members
parent_class: GtkApplicationClass

The parent class.