Handy – 1
Description: Reference for Handy-1

### Namespace

# Handy – 1

Building blocks for modern adaptive GNOME apps

Version | 1.8.2
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
Gtk—3.0 | The GTK toolkit
| 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. since: 1.0
ApplicationWindow | A freeform application window. since: 1.0
Avatar | A widget displaying an image, with a generated fallback. since: 1.0
Carousel | A paginated scrolling widget. since: 1.0
CarouselIndicatorDots | A dots indicator for `HdyCarousel`. since: 1.0
CarouselIndicatorLines | A lines indicator for `HdyCarousel`. since: 1.0
Clamp | A widget constraining its child to a given size. since: 1.0
ComboRow | A `GtkListBoxRow` used to choose from a list of items. since: 1.0
Deck | A swipeable widget showing one of the visible children at a time. since: 1.0
EnumValueObject | An object representing an `GEnumValue`. 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.2
HeaderBar | A title bar widget. since: 1.0
HeaderGroup | An object handling composite title bars. since: 1.0
HeaderGroupChild | A child object for `HdyHeaderGroup`. since: 1.0
Keypad | A keypad for dialing numbers. since: 1.0
Leaflet | An adaptive container acting like a box or a stack. since: 1.0
PreferencesGroup | A group of preference rows. since: 1.0
PreferencesPage | A page from `HdyPreferencesWindow`. 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
SearchBar | A toolbar to integrate a search entry with. since: 1.0
Squeezer | A best fit container. since: 1.0
StatusPage | A page used for empty/error states and similar use-cases. since: 1.2
StyleManager | A class for managing application-wide styling. since: 1.6
SwipeGroup | An object for syncing swipeable widgets. deprecated: 1.4 since: 1.0
SwipeTracker | Swipe tracker used in `HdyCarousel` and `HdyLeaflet`. since: 1.0
TabBar | A tab bar for `HdyTabView`. since: 1.2
TabPage | An auxiliary class used by `HdyTabView`. since: 1.2
TabView | A dynamic tabbed container. since: 1.2
TitleBar | A simple title bar container. deprecated: 1.4 since: 1.0
ValueObject | An object representing a `GValue`. 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
WindowHandle | A bin that acts like a titlebar. since: 1.0

#### Interfaces

Swipeable | An interface for swipeable widgets. since: 1.0

#### Enumerations

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

#### Callbacks

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

#### Functions

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