### Namespace

# Handy – 1

Building blocks for modern adaptive GNOME apps

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

#### Build

C headers | `handy.h`
pkg-config files | `libhandy-1`

#### Dependencies

GObject—2.0 | The base type system library
| Browse documentation

#### Additional documentation

- Compiling with Libhandy
- Migrating from Handy 0.0.x to Handy 1
- Visual Index
- Classes Hierarchy

#### Classes

ActionRow | A `GtkListBoxRow` used to present actions.
ApplicationWindow | A freeform application window.
Avatar | A widget displaying an image, with a generated fallback.
Carousel | A paginated scrolling widget.
CarouselIndicatorDots | A dots indicator for `HdyCarousel`.
CarouselIndicatorLines | A lines indicator for `HdyCarousel`.
Clamp | A widget constraining its child to a given size.
ComboRow | A `GtkListBoxRow` used to choose from a list of items.
Deck | A swipeable widget showing one of the visible children at a time.
EnumValueObject | An object representing an `GEnumValue`.
ExpanderRow | A `GtkListBoxRow` used to reveal widgets.
Flap | An adaptive container acting like a box or an overlay.
HeaderBar | A title bar widget.
HeaderGroup | An object handling composite title bars.
HeaderGroupChild | A child object for `HdyHeaderGroup`.
Keypad | A keypad for dialing numbers.
Leaflet | An adaptive container acting like a box or a stack.
PreferencesGroup | A group of preference rows.
PreferencesPage | A page from `HdyPreferencesWindow`.
PreferencesRow | A `GtkListBoxRow` used to present preferences.
PreferencesWindow | A window to present an application’s preferences.
SearchBar | A toolbar to integrate a search entry with.
Squeezer | A best fit container.
StatusPage | A page used for empty/error states and similar use-cases.
StyleManager | A class for managing application-wide styling.
SwipeGroup | An object for syncing swipeable widgets.
SwipeTracker | Swipe tracker used in `HdyCarousel` and `HdyLeaflet`.
TabBar | A tab bar for `HdyTabView`.
TabPage | An auxiliary class used by `HdyTabView`.
TabView | A dynamic tabbed container.
TitleBar | A simple title bar container.
ValueObject | An object representing a `GValue`.
ViewSwitcher | An adaptive view switcher.
ViewSwitcherBar | A view switcher action bar.
ViewSwitcherTitle | A view switcher title.
Window | A freeform window.
WindowHandle | A bin that acts like a titlebar.

#### Interfaces

Swipeable | An interface for swipeable widgets.

#### Enumerations

CenteringPolicy | Describes title centering behavior of a `HdyHeaderBar` widget.
ColorScheme | Application color schemes for `HdyStyleManager:color-scheme`.
DeckTransitionType | Describes the possible transitions in a `HdyDeck` widget.
FlapFoldPolicy | Describes the possible folding behavior of a `HdyFlap` widget.
FlapTransitionType | Describes transitions types of a `HdyFlap` widget.
HeaderGroupChildType | Describes the child types handled by `HdyHeaderGroup`.
LeafletTransitionType | Describes the possible transitions in a `HdyLeaflet` widget.
NavigationDirection | Describes the direction of a swipe navigation gesture.
SqueezerTransitionType | Describes the possible transitions in a `HdySqueezer` widget.
ViewSwitcherPolicy | Describes the adaptive modes of `HdyViewSwitcher`.

#### Callbacks

AvatarImageLoadFunc | Callback for loading an `HdyAvatar`‘s image.
ComboRowGetEnumValueNameFunc | Callback for getting the name of a row from an enum.
ComboRowGetNameFunc | Callback for getting the name of a row.

#### Functions

ease_out_cubic | Computes the ease out for a value.
enum_value_row_name | Returns the name of a `HdyEnumValueObject`.
get_enable_animations | Checks whether animations are enabled for `widget`.
init | Initializes Libhandy.