Namespace

Adw – 1

Building blocks for modern GNOME applications

Version1.4.0
AuthorsPurism SPC
LicenseLGPL-2.1-or-later
Websitehttps://gnome.pages.gitlab.gnome.org/libadwaita
Sourcehttps://gitlab.gnome.org/GNOME/libadwaita/

Build

C headersadwaita.h
pkg-config fileslibadwaita-1

Dependencies

GObject—2.0 The base type system library
Browse documentation
Gtk—4.0 The GTK toolkit
Browse documentation

Classes

AboutWindow

A window showing information about the application.

since: 1.2

ActionRow

A GtkListBoxRow used to present actions.

since: 1

Animation

A base class for animations.

since: 1

AnimationTarget

Represents a value AdwAnimation can animate.

since: 1

Application

A base class for Adwaita applications.

since: 1

ApplicationWindow

A freeform application window.

since: 1

Avatar

A widget displaying an image, with a generated fallback.

since: 1

Banner

A bar with contextual information.

since: 1.3

Bin

A widget with one child.

since: 1

Breakpoint

Describes a breakpoint for AdwWindow.

since: 1.4

BreakpointBin

A widget that changes layout based on available size.

since: 1.4

ButtonContent

A helper widget for creating buttons.

since: 1

CallbackAnimationTarget

An AdwAnimationTarget that calls a given callback during the animation.

since: 1

Carousel

A paginated scrolling widget.

since: 1

CarouselIndicatorDots

A dots indicator for AdwCarousel.

since: 1

CarouselIndicatorLines

A lines indicator for AdwCarousel.

since: 1

Clamp

A widget constraining its child to a given size.

since: 1

ClampLayout

A layout manager constraining its children to a given size.

since: 1

ClampScrollable

A scrollable AdwClamp.

since: 1

ComboRow

A GtkListBoxRow used to choose from a list of items.

since: 1

EntryRow

A GtkListBoxRow with an embedded text entry.

since: 1.2

EnumListItem

AdwEnumListItem is the type of items in a AdwEnumListModel.

since: 1

EnumListModel

A GListModel representing values of a given enum.

since: 1

ExpanderRow

A GtkListBoxRow used to reveal widgets.

since: 1

Flap

An adaptive container acting like a box or an overlay.

deprecated: 1.4 since: 1

HeaderBar

A title bar widget.

since: 1

Leaflet

An adaptive container acting like a box or a stack.

deprecated: 1.4 since: 1

LeafletPage

An auxiliary class used by AdwLeaflet.

deprecated: 1.4 since: 1

MessageDialog

A dialog presenting a message or a question.

since: 1.2

NavigationPage

A page within AdwNavigationView or AdwNavigationSplitView.

since: 1.4

NavigationSplitView

A widget presenting sidebar and content side by side or as a navigation view.

since: 1.4

NavigationView

A page-based navigation container.

since: 1.4

OverlaySplitView

A widget presenting sidebar and content side by side or as an overlay.

since: 1.4

PasswordEntryRow

A AdwEntryRow tailored for entering secrets.

since: 1.2

PreferencesGroup

A group of preference rows.

since: 1

PreferencesPage

A page from AdwPreferencesWindow.

since: 1

PreferencesRow

A GtkListBoxRow used to present preferences.

since: 1

PreferencesWindow

A window to present an application’s preferences.

since: 1

PropertyAnimationTarget

An AdwAnimationTarget changing the value of a property of a GObject instance.

since: 1.2

SpinRow

An AdwActionRow with an embedded spin button.

since: 1.4

SplitButton

A combined button and dropdown widget.

since: 1

SpringAnimation

A spring-based AdwAnimation.

since: 1

Squeezer

A best fit container.

deprecated: 1.4 since: 1

SqueezerPage

An auxiliary class used by AdwSqueezer.

deprecated: 1.4 since: 1

StatusPage

A page used for empty/error states and similar use-cases.

since: 1

StyleManager

A class for managing application-wide styling.

since: 1

SwipeTracker

A swipe tracker used in AdwCarousel, AdwNavigationView and AdwOverlaySplitView.

since: 1

SwitchRow

A GtkListBoxRow used to represent two states.

since: 1.4

TabBar

A tab bar for AdwTabView.

since: 1

TabButton

A button that displays the number of AdwTabView pages.

since: 1.3

TabOverview

A tab overview for AdwTabView.

since: 1.3

TabPage

An auxiliary class used by AdwTabView.

since: 1

TabView

A dynamic tabbed container.

since: 1

TimedAnimation

A time-based AdwAnimation.

since: 1

Toast

A helper object for AdwToastOverlay.

since: 1

ToastOverlay

A widget showing toasts above its content.

since: 1

ToolbarView

A widget containing a page, as well as top and/or bottom bars.

since: 1.4

ViewStack

A view container for AdwViewSwitcher.

since: 1

ViewStackPage

An auxiliary class used by AdwViewStack.

since: 1

ViewStackPages

An auxiliary class used by AdwViewStack.

since: 1.4

ViewSwitcher

An adaptive view switcher.

since: 1

ViewSwitcherBar

A view switcher action bar.

since: 1

ViewSwitcherTitle

A view switcher title.

deprecated: 1.4 since: 1

Window

A freeform window.

since: 1

WindowTitle

A helper widget for setting a window’s title and subtitle.

since: 1

Interfaces

Swipeable

An interface for swipeable widgets.

since: 1

Structs

BreakpointCondition

Describes condition for an AdwBreakpoint.

since: 1.4

SpringParams

Physical parameters of a spring for AdwSpringAnimation.

since: 1

Enumerations

AnimationState

Describes the possible states of an AdwAnimation.

since: 1

BreakpointConditionLengthType

Describes length types for AdwBreakpointCondition.

since: 1.4

BreakpointConditionRatioType

Describes ratio types for AdwBreakpointCondition.

since: 1.4

CenteringPolicy

Describes title centering behavior of a AdwHeaderBar widget.

since: 1

ColorScheme

Application color schemes for AdwStyleManager:color-scheme.

since: 1

Easing

Describes the available easing functions for use with AdwTimedAnimation.

since: 1

FlapFoldPolicy

Describes the possible folding behavior of a AdwFlap widget.

deprecated: 1.4 since: 1

FlapTransitionType

Describes transitions types of a AdwFlap widget.

deprecated: 1.4 since: 1

FoldThresholdPolicy

Determines when AdwFlap and AdwLeaflet will fold.

deprecated: 1.4 since: 1

LeafletTransitionType

Describes the possible transitions in a AdwLeaflet widget.

deprecated: 1.4 since: 1

LengthUnit

Describes length units.

since: 1.4

NavigationDirection

Describes the direction of a swipe navigation gesture.

since: 1

ResponseAppearance

Describes the possible styles of AdwMessageDialog response buttons.

since: 1.2

SqueezerTransitionType

Describes the possible transitions in a AdwSqueezer widget.

deprecated: 1.4 since: 1

ToastPriority

AdwToast behavior when another toast is already displayed.

since: 1

ToolbarStyle

Describes the possible top or bottom bar styles in an AdwToolbarView widget.

since: 1.4

ViewSwitcherPolicy

Describes the adaptive modes of AdwViewSwitcher.

since: 1

Bitfields

TabViewShortcuts

Describes available shortcuts in an AdwTabView.

since: 1.2

Callbacks

AnimationTargetFunc

Prototype for animation targets based on user callbacks.

since: 1

Functions

get_enable_animations

Checks whether animations are enabled for widget.

since: 1

get_major_version

Returns the major version number of the Adwaita library.

since: 1

get_micro_version

Returns the micro version number of the Adwaita library.

since: 1

get_minor_version

Returns the minor version number of the Adwaita library.

since: 1

init

Initializes Libadwaita.

since: 1

is_initialized

Use this function to check if libadwaita has been initialized with adw_init().

since: 1

lerp

Computes the linear interpolation between a and b for t.

since: 1

show_about_window

A convenience function for showing an application’s about window.

since: 1.2

show_about_window_from_appdata

A convenience function for showing an application’s about window from AppStream metadata.

since: 1.4

Function Macros

CHECK_VERSION

Compile-time version checking. Evaluates to TRUE if the version of Adwaita is greater than the required one.

since: 1

DEPRECATED_IN_1_1_FOR

since: 1

DEPRECATED_IN_1_2_FOR

since: 1

DEPRECATED_IN_1_3_FOR

since: 1

DEPRECATED_IN_1_4_FOR

since: 1

DEPRECATED_TYPE_IN_1_1_FOR

since: 1

DEPRECATED_TYPE_IN_1_2_FOR

since: 1

DEPRECATED_TYPE_IN_1_3_FOR

since: 1

DEPRECATED_TYPE_IN_1_4_FOR

since: 1

ENCODE_VERSION

since: 1

UNAVAILABLE

since: 1

Constants

DURATION_INFINITE

Indicates an AdwAnimation with an infinite duration.

since: 1

MAJOR_VERSION

Adwaita major version component (e.g. 1 if the version is 1.2.3).

since: 1

MICRO_VERSION

Adwaita micro version component (e.g. 3 if the version is 1.2.3).

since: 1

MINOR_VERSION

Adwaita minor version component (e.g. 2 if the version is 1.2.3).

since: 1

VERSION_S

Adwaita version, encoded as a string, useful for printing and concatenation.

since: 1