Namespace

Adw – 1

Building blocks for modern GNOME applications

Version1.3.6
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.

Animation

A base class for animations.

AnimationTarget

Represents a value AdwAnimation can animate.

Application

A base class for Adwaita applications.

ApplicationWindow

A freeform application window.

Avatar

A widget displaying an image, with a generated fallback.

Banner

A bar with contextual information.

since: 1.3

Bin

A widget with one child.

ButtonContent

A helper widget for creating buttons.

CallbackAnimationTarget

An AdwAnimationTarget that calls a given callback during the animation.

Carousel

A paginated scrolling widget.

CarouselIndicatorDots

A dots indicator for AdwCarousel.

CarouselIndicatorLines

A lines indicator for AdwCarousel.

Clamp

A widget constraining its child to a given size.

ClampLayout

A layout manager constraining its children to a given size.

ClampScrollable

A scrollable AdwClamp.

ComboRow

A GtkListBoxRow used to choose from a list of items.

EntryRow

A GtkListBoxRow with an embedded text entry.

since: 1.2

EnumListItem

AdwEnumListItem is the type of items in a AdwEnumListModel.

EnumListModel

A GListModel representing values of a given enum.

ExpanderRow

A GtkListBoxRow used to reveal widgets.

Flap

An adaptive container acting like a box or an overlay.

HeaderBar

A title bar widget.

Leaflet

An adaptive container acting like a box or a stack.

LeafletPage

An auxiliary class used by AdwLeaflet.

MessageDialog

A dialog presenting a message or a question.

since: 1.2

PasswordEntryRow

A AdwEntryRow tailored for entering secrets.

since: 1.2

PreferencesGroup

A group of preference rows.

PreferencesPage

A page from AdwPreferencesWindow.

PreferencesRow

A GtkListBoxRow used to present preferences.

PreferencesWindow

A window to present an application’s preferences.

PropertyAnimationTarget

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

since: 1.2

SplitButton

A combined button and dropdown widget.

SpringAnimation

A spring-based AdwAnimation.

Squeezer

A best fit container.

SqueezerPage

An auxiliary class used by AdwSqueezer.

StatusPage

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

StyleManager

A class for managing application-wide styling.

SwipeTracker

A swipe tracker used in AdwCarousel, AdwFlap and AdwLeaflet.

TabBar

A tab bar for AdwTabView.

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.

TabView

A dynamic tabbed container.

TimedAnimation

A time-based AdwAnimation.

Toast

A helper object for AdwToastOverlay.

ToastOverlay

A widget showing toasts above its content.

ViewStack

A view container for AdwViewSwitcher.

ViewStackPage

An auxiliary class used by AdwViewStack.

ViewSwitcher

An adaptive view switcher.

ViewSwitcherBar

A view switcher action bar.

ViewSwitcherTitle

A view switcher title.

Window

A freeform window.

WindowTitle

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

Interfaces

Swipeable

An interface for swipeable widgets.

Structs

SpringParams

Physical parameters of a spring for AdwSpringAnimation.

Enumerations

AnimationState

Describes the possible states of an AdwAnimation.

CenteringPolicy

Describes title centering behavior of a AdwHeaderBar widget.

ColorScheme

Application color schemes for AdwStyleManager:color-scheme.

Easing

Describes the available easing functions for use with AdwTimedAnimation.

FlapFoldPolicy

Describes the possible folding behavior of a AdwFlap widget.

FlapTransitionType

Describes transitions types of a AdwFlap widget.

FoldThresholdPolicy

Determines when AdwFlap and AdwLeaflet will fold.

LeafletTransitionType

Describes the possible transitions in a AdwLeaflet widget.

NavigationDirection

Describes the direction of a swipe navigation gesture.

ResponseAppearance

Describes the possible styles of AdwMessageDialog response buttons.

since: 1.2

SqueezerTransitionType

Describes the possible transitions in a AdwSqueezer widget.

ToastPriority

AdwToast behavior when another toast is already displayed.

ViewSwitcherPolicy

Describes the adaptive modes of AdwViewSwitcher.

Bitfields

TabViewShortcuts

Describes available shortcuts in an AdwTabView.

since: 1.2

Callbacks

AnimationTargetFunc

Prototype for animation targets based on user callbacks.

Functions

get_enable_animations

Checks whether animations are enabled for widget.

get_major_version

Returns the major version number of the Adwaita library.

get_micro_version

Returns the micro version number of the Adwaita library.

get_minor_version

Returns the minor version number of the Adwaita library.

init

Initializes Libadwaita.

is_initialized

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

lerp

Computes the linear interpolation between a and b for t.

show_about_window

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

since: 1.2

Function Macros

CHECK_VERSION

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

DEPRECATED_IN_1_1_FOR

DEPRECATED_IN_1_2_FOR

DEPRECATED_IN_1_3_FOR

DEPRECATED_TYPE_IN_1_1_FOR

DEPRECATED_TYPE_IN_1_2_FOR

DEPRECATED_TYPE_IN_1_3_FOR

ENCODE_VERSION

UNAVAILABLE

Constants

DURATION_INFINITE

Indicates an AdwAnimation with an infinite duration.

MAJOR_VERSION

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

MICRO_VERSION

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

MINOR_VERSION

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

VERSION_S

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