Adw – 1
Description: Reference for Adw-1

### Namespace

# Adw – 1

Building blocks for modern GNOME applications

Version | 1.2.3
Authors | Purism SPC
License | LGPL-2.1-or-later
Website | https://gnome.pages.gitlab.gnome.org/libadwaita
Source | https://gitlab.gnome.org/GNOME/libadwaita/

#### Build

C headers | `adwaita.h`
pkg-config files | `libadwaita-1`

#### Dependencies

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

#### Additional documentation

- Compiling with Libadwaita
- Initialization
- Boxed Lists
- Adaptive Layouts
- Styles & Appearance
- Named Colors
- Style Classes
- Migrating between development versions
- Migrating from Libhandy 1.4 to Libadwaita
- Visual Index
- Classes Hierarchy

#### Classes

AboutWindow | A window showing information about the application. since: 1.2
ActionRow | A `GtkListBoxRow` used to present actions. since: 1.0
Animation | A base class for animations. since: 1.0
AnimationTarget | Represents a value `AdwAnimation` can animate. since: 1.0
Application | A base class for Adwaita applications. since: 1.0
ApplicationWindow | A freeform application window. since: 1.0
Avatar | A widget displaying an image, with a generated fallback. since: 1.0
Bin | A widget with one child. since: 1.0
ButtonContent | A helper widget for creating buttons. since: 1.0
CallbackAnimationTarget | An `AdwAnimationTarget` that calls a given callback during the animation. since: 1.0
Carousel | A paginated scrolling widget. since: 1.0
CarouselIndicatorDots | A dots indicator for `AdwCarousel`. since: 1.0
CarouselIndicatorLines | A lines indicator for `AdwCarousel`. since: 1.0
Clamp | A widget constraining its child to a given size. since: 1.0
ClampLayout | A layout manager constraining its children to a given size. since: 1.0
ClampScrollable | A scrollable `AdwClamp`. since: 1.0
ComboRow | A `GtkListBoxRow` used to choose from a list of items. since: 1.0
EntryRow | A `GtkListBoxRow` with an embedded text entry. since: 1.2
EnumListItem | `AdwEnumListItem` is the type of items in a `AdwEnumListModel`. since: 1.0
EnumListModel | A `GListModel` representing values of a given enum. since: 1.0
ExpanderRow | A `GtkListBoxRow` used to reveal widgets. since: 1.0
Flap | An adaptive container acting like a box or an overlay. since: 1.0
HeaderBar | A title bar widget. since: 1.0
Leaflet | An adaptive container acting like a box or a stack. since: 1.0
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. since: 1.0
PreferencesPage | A page from `AdwPreferencesWindow`. since: 1.0
PreferencesRow | A `GtkListBoxRow` used to present preferences. since: 1.0
PreferencesWindow | A window to present an application’s preferences. since: 1.0
PropertyAnimationTarget | An `AdwAnimationTarget` changing the value of a property of a `GObject` instance. since: 1.2
SplitButton | A combined button and dropdown widget. since: 1.0
SpringAnimation | A spring-based `AdwAnimation`. since: 1.0
Squeezer | A best fit container. since: 1.0
SqueezerPage | An auxiliary class used by `AdwSqueezer`.
StatusPage | A page used for empty/error states and similar use-cases. since: 1.0
StyleManager | A class for managing application-wide styling. since: 1.0
SwipeTracker | A swipe tracker used in `AdwCarousel`, `AdwFlap` and `AdwLeaflet`. since: 1.0
TabBar | A tab bar for `AdwTabView`. since: 1.0
TabPage | An auxiliary class used by `AdwTabView`.
TabView | A dynamic tabbed container. since: 1.0
TimedAnimation | A time-based `AdwAnimation`. since: 1.0
Toast | A helper object for `AdwToastOverlay`. since: 1.0
ToastOverlay | A widget showing toasts above its content. since: 1.0
ViewStack | A view container for `AdwViewSwitcher`. since: 1.0
ViewStackPage | An auxiliary class used by `AdwViewStack`. since: 1.0
ViewSwitcher | An adaptive view switcher. since: 1.0
ViewSwitcherBar | A view switcher action bar. since: 1.0
ViewSwitcherTitle | A view switcher title. since: 1.0
Window | A freeform window. since: 1.0
WindowTitle | A helper widget for setting a window’s title and subtitle. since: 1.0

#### Interfaces

Swipeable | An interface for swipeable widgets. since: 1.0

#### Structs

SpringParams | Physical parameters of a spring for `AdwSpringAnimation`. since: 1.0

#### Enumerations

AnimationState | Describes the possible states of an `AdwAnimation`. since: 1.0
CenteringPolicy | Describes title centering behavior of a `AdwHeaderBar` widget. since: 1.0
ColorScheme | Application color schemes for `AdwStyleManager:color-scheme`. since: 1.0
Easing | Describes the available easing functions for use with `AdwTimedAnimation`. since: 1.0
FlapFoldPolicy | Describes the possible folding behavior of a `AdwFlap` widget. since: 1.0
FlapTransitionType | Describes transitions types of a `AdwFlap` widget. since: 1.0
FoldThresholdPolicy | Determines when `AdwFlap` and `AdwLeaflet` will fold. since: 1.0
LeafletTransitionType | Describes the possible transitions in a `AdwLeaflet` widget. since: 1.0
NavigationDirection | Describes the direction of a swipe navigation gesture. since: 1.0
ResponseAppearance | Describes the possible styles of `AdwMessageDialog` response buttons. since: 1.2
SqueezerTransitionType | Describes the possible transitions in a `AdwSqueezer` widget. since: 1.0
ToastPriority | `AdwToast` behavior when another toast is already displayed. since: 1.0
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. since: 1.0

#### Functions

get_enable_animations | Checks whether animations are enabled for `widget`. since: 1.0
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. since: 1.0
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`. since: 1.0
show_about_window | A convenience function for showing an application’s about window.

#### 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_TYPE_IN_1_1_FOR |
DEPRECATED_TYPE_IN_1_2_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.