Package org.gnome.adw

Class Application

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gio.Application

org.gnome.gtk.Application

org.gnome.adw.Application

All Implemented Interfaces:

ActionGroup, ActionMap, Proxy

@Generated("io.github.jwharm.JavaGI")
public class Application
extends Application
implements ActionGroup, ActionMap

A base class for Adwaita applications.

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

Automatic Resources
Shortcuts Dialog
If there's a resource located at shortcuts-dialog.ui which defines an ShortcutsDialog with the ID shortcuts_dialog, AdwApplication will set up an app.shortcuts action that creates and presents this dialog, as well as a Ctrl? accelerator for it.

Stylesheet
AdwApplication will automatically load stylesheets located in the application's resource base path (see Application.setResourceBasePath(java.lang.String), 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 StyleManager: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 StyleManager:dark is TRUE.

:::note style.css can contain styles for dark and high contrast appearance as well, using media queries:

• prefers-color-scheme: dark for styles used only for dark appearance.
• prefers-contrast: more for styles used only when the system high contrast preference is enabled.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Application.ApplicationClass
static class	Application.Builder<B extends Application.Builder<B>>	Inner class implementing a builder pattern to construct a GObject with properties.

Nested classes/interfaces inherited from class org.gnome.gtk.Application

Application.QueryEndCallback, Application.WindowAddedCallback, Application.WindowRemovedCallback

Nested classes/interfaces inherited from class org.gnome.gio.Application

Application.ActivateCallback, Application.CommandLineCallback, Application.HandleLocalOptionsCallback, Application.NameLostCallback, Application.OpenCallback, Application.ShutdownCallback, Application.StartupCallback

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gio.ActionGroup

ActionGroup.ActionAddedCallback, ActionGroup.ActionEnabledChangedCallback, ActionGroup.ActionGroup$Impl, ActionGroup.ActionGroupInterface, ActionGroup.ActionRemovedCallback, ActionGroup.ActionStateChangedCallback

Nested classes/interfaces inherited from interface org.gnome.gio.ActionMap

ActionMap.ActionMap$Impl, ActionMap.ActionMapInterface

Constructor Summary

Constructors

Constructor	Description
Application()	Creates a new Application.
Application(@Nullable String applicationId, Set<ApplicationFlags> flags)	Creates a new AdwApplication.
Application(@Nullable String applicationId, ApplicationFlags... flags)	Creates a new AdwApplication.
Application(MemorySegment address)	Create a Application proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
protected Application	asParent()	Returns this instance as if it were its parent type.
static Application.Builder<? extends Application.Builder>	builder()	A Application.Builder object constructs a Application with the specified properties.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
StyleManager	getStyleManager()	Gets the style manager for self.
static @Nullable Type	getType()	Get the GType of the Application class

Methods inherited from class org.gnome.gtk.Application

addWindow, emitQueryEnd, emitWindowAdded, emitWindowRemoved, getAccelsForAction, getActionsForAccel, getActiveWindow, getMenubar, getMenuById, getWindowById, getWindows, inhibit, inhibit, listActionDescriptions, onQueryEnd, onWindowAdded, onWindowRemoved, removeWindow, setAccelsForAction, setMenubar, uninhibit, windowAdded, windowRemoved

Methods inherited from class org.gnome.gio.Application

activate, addMainOption, addMainOption, addMainOptionEntries, addOptionGroup, addPlatformData, afterEmit, beforeEmit, bindBusyProperty, commandLine, dbusRegister, dbusUnregister, emitActivate, emitCommandLine, emitHandleLocalOptions, emitNameLost, emitOpen, emitShutdown, emitStartup, getApplicationId, getDbusConnection, getDbusObjectPath, getDefault, getFlags, getInactivityTimeout, getIsBusy, getIsRegistered, getIsRemote, getResourceBasePath, getVersion, handleLocalOptions, hold, idIsValid, localCommandLine, markBusy, nameLost, onActivate, onCommandLine, onHandleLocalOptions, onNameLost, onOpen, onShutdown, onStartup, open, quit, quitMainloop, register, release, run, runMainloop, sendNotification, setActionGroup, setApplicationId, setDefault, setFlags, setFlags, setInactivityTimeout, setOptionContextDescription, setOptionContextParameterString, setOptionContextSummary, setResourceBasePath, setVersion, shutdown, startup, unbindBusyProperty, unmarkBusy, withdrawNotification

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gnome.gio.ActionGroup

actionAdded, actionEnabledChanged, actionRemoved, actionStateChanged, activateAction, changeActionState, emitActionAdded, emitActionEnabledChanged, emitActionRemoved, emitActionStateChanged, getActionEnabled, getActionParameterType, getActionState, getActionStateHint, getActionStateType, hasAction, listActions, onActionAdded, onActionEnabledChanged, onActionRemoved, onActionStateChanged, queryAction

Methods inherited from interface org.gnome.gio.ActionMap

addAction, addActionEntries, lookupAction, removeAction, removeActionEntries

Methods inherited from interface org.javagi.base.Proxy

handle

Constructor Details

Application

public Application(MemorySegment address)

Create a Application proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Application

public Application(@Nullable String applicationId,
 Set<ApplicationFlags> flags)

Creates a new AdwApplication.

If application_id is not NULL, then it must be valid. See Application.idIsValid(java.lang.String).

If no application ID is given then some features (most notably application uniqueness) will be disabled.

Parameters:

applicationId - The application ID

flags - The application flags

Application

public Application(@Nullable String applicationId,
 ApplicationFlags... flags)

Creates a new AdwApplication.

If application_id is not NULL, then it must be valid. See Application.idIsValid(java.lang.String).

If no application ID is given then some features (most notably application uniqueness) will be disabled.

Parameters:

applicationId - The application ID

flags - The application flags

Application

public Application()

Creates a new Application.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the Application class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected Application asParent()

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class Application

getStyleManager

public StyleManager getStyleManager()

Gets the style manager for self.

This is a convenience property allowing to access AdwStyleManager through property bindings or expressions.

Returns:

the style manager

builder

public static Application.Builder<? extends Application.Builder> builder()

A Application.Builder object constructs a Application with the specified properties. Use the various set...() methods to set properties, and finish construction with Application.Builder.build().

Returns:

the builder object