Package org.gnome.adw

Class Leaflet

java.lang.Object

org.javagi.base.ProxyInstance

org.gnome.gobject.TypeInstance

org.gnome.gobject.GObject

org.gnome.gobject.InitiallyUnowned

org.gnome.gtk.Widget

org.gnome.adw.Leaflet

All Implemented Interfaces:

Swipeable, Accessible, Buildable, ConstraintTarget, Orientable, Proxy

@Generated("io.github.jwharm.JavaGI")
@Deprecated
public final class Leaflet
extends Widget
implements Swipeable, Accessible, Buildable, ConstraintTarget, Orientable

Deprecated.

See the migration guide

An adaptive container acting like a box or a stack.

The AdwLeaflet widget can display its children like a Box does or like a Stack does, adapting to size changes by switching between the two modes.

When there is enough space the children are displayed side by side, otherwise only one is displayed and the leaflet is said to be “folded”. The threshold is dictated by the preferred minimum sizes of the children. When a leaflet is folded, the children can be navigated using swipe gestures.

The “over” and “under” transition types stack the children one on top of the other, while the “slide” transition puts the children side by side. While navigating to a child on the side or below can be performed by swiping the current child away, navigating to an upper child requires dragging it from the edge where it resides. This doesn't affect non-dragging swipes.

CSS nodes
AdwLeaflet has a single CSS node with name leaflet. The node will get the style classes .folded when it is folded, .unfolded when it's not, or none if it hasn't computed its fold yet.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Leaflet.Builder<B extends Leaflet.Builder<B>>	Deprecated. Inner class implementing a builder pattern to construct a GObject with properties.
static class	Leaflet.LeafletClass	Deprecated.

Nested classes/interfaces inherited from class org.gnome.gtk.Widget

Widget.DestroyCallback, Widget.DirectionChangedCallback, Widget.HideCallback, Widget.KeynavFailedCallback, Widget.MapCallback, Widget.MnemonicActivateCallback, Widget.MoveFocusCallback, Widget.QueryTooltipCallback, Widget.RealizeCallback, Widget.ShowCallback, Widget.StateFlagsChangedCallback, Widget.UnmapCallback, Widget.UnrealizeCallback, Widget.Widget$Impl, Widget.WidgetClass

Nested classes/interfaces inherited from class org.gnome.gobject.InitiallyUnowned

InitiallyUnowned.InitiallyUnownedClass

Nested classes/interfaces inherited from class org.gnome.gobject.GObject

GObject.NotifyCallback, GObject.ObjectClass

Nested classes/interfaces inherited from interface org.gnome.gtk.Accessible

Accessible.Accessible$Impl, Accessible.AccessibleInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Buildable

Buildable.Buildable$Impl, Buildable.BuildableIface

Nested classes/interfaces inherited from interface org.gnome.gtk.ConstraintTarget

ConstraintTarget.ConstraintTarget$Impl, ConstraintTarget.ConstraintTargetInterface

Nested classes/interfaces inherited from interface org.gnome.gtk.Orientable

Orientable.Orientable$Impl, Orientable.OrientableIface

Nested classes/interfaces inherited from interface org.gnome.adw.Swipeable

Swipeable.Swipeable$Impl, Swipeable.SwipeableInterface

Constructor Summary

Constructors

Constructor	Description
Leaflet()	Deprecated. Creates a new Leaflet.
Leaflet(MemorySegment address)	Deprecated. Create a Leaflet proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
LeafletPage	append(Widget child)	Deprecated. See the migration guide
protected Leaflet	asParent()	Deprecated. Returns this instance as if it were its parent type.
static Leaflet.Builder<? extends Leaflet.Builder>	builder()	Deprecated. A Leaflet.Builder object constructs a Leaflet with the specified properties.
@Nullable Widget	getAdjacentChild(NavigationDirection direction)	Deprecated. See the migration guide
boolean	getCanNavigateBack()	Deprecated. See the migration guide
boolean	getCanNavigateForward()	Deprecated. See the migration guide
boolean	getCanUnfold()	Deprecated. See the migration guide
@Nullable Widget	getChildByName(String name)	Deprecated. See the migration guide
SpringParams	getChildTransitionParams()	Deprecated. See the migration guide
boolean	getChildTransitionRunning()	Deprecated. See the migration guide
boolean	getFolded()	Deprecated. See the migration guide
FoldThresholdPolicy	getFoldThresholdPolicy()	Deprecated. See the migration guide
boolean	getHomogeneous()	Deprecated. See the migration guide
int	getModeTransitionDuration()	Deprecated. See the migration guide
LeafletPage	getPage(Widget child)	Deprecated. See the migration guide
SelectionModel	getPages()	Deprecated. See the migration guide
LeafletTransitionType	getTransitionType()	Deprecated. See the migration guide
static @Nullable Type	getType()	Deprecated. Get the GType of the Leaflet class
@Nullable Widget	getVisibleChild()	Deprecated. See the migration guide
@Nullable String	getVisibleChildName()	Deprecated. See the migration guide
LeafletPage	insertChildAfter(Widget child, @Nullable Widget sibling)	Deprecated. See the migration guide
boolean	navigate(NavigationDirection direction)	Deprecated. See the migration guide
LeafletPage	prepend(Widget child)	Deprecated. See the migration guide
void	remove(Widget child)	Deprecated. See the migration guide
void	reorderChildAfter(Widget child, @Nullable Widget sibling)	Deprecated. See the migration guide
void	setCanNavigateBack(boolean canNavigateBack)	Deprecated. See the migration guide
void	setCanNavigateForward(boolean canNavigateForward)	Deprecated. See the migration guide
void	setCanUnfold(boolean canUnfold)	Deprecated. See the migration guide
void	setChildTransitionParams(SpringParams params)	Deprecated. See the migration guide
void	setFoldThresholdPolicy(FoldThresholdPolicy policy)	Deprecated. See the migration guide
void	setHomogeneous(boolean homogeneous)	Deprecated. See the migration guide
void	setModeTransitionDuration(int duration)	Deprecated. See the migration guide
void	setTransitionType(LeafletTransitionType transition)	Deprecated. See the migration guide
void	setVisibleChild(Widget visibleChild)	Deprecated. See the migration guide
void	setVisibleChildName(String name)	Deprecated. See the migration guide

Methods inherited from class org.gnome.gtk.Widget

actionSetEnabled, activateActionIfExists, activateDefault, activateWidget, addController, addCssClass, addMnemonicLabel, addTickCallback, allocate, childFocus, computeBounds, computeExpand, computeExpand, computePoint, computeTransform, contains, createPangoContext, createPangoLayout, cssChanged, directionChanged, disposeTemplate, dragCheckThreshold, emitDestroy, emitDirectionChanged, emitHide, emitKeynavFailed, emitMap, emitMnemonicActivate, emitMoveFocus, emitQueryTooltip, emitRealize, emitShow, emitStateFlagsChanged, emitUnmap, emitUnrealize, errorBell, focus, getAllocatedBaseline, getAllocatedHeight, getAllocatedWidth, getAllocation, getAncestor, getBaseline, getCanFocus, getCanTarget, getChildVisible, getClipboard, getColor, getCssClasses, getCssName, getCursor, getDefaultDirection, getDirection, getDisplay, getFirstChild, getFocusable, getFocusChild, getFocusOnClick, getFontMap, getFontOptions, getFrameClock, getHalign, getHasTooltip, getHeight, getHexpand, getHexpandSet, getLastChild, getLayoutManager, getLimitEvents, getMapped, getMarginBottom, getMarginEnd, getMarginStart, getMarginTop, getMemoryLayout, getName, getNative, getNextSibling, getOpacity, getOverflow, getPangoContext, getParent, getPreferredSize, getPrevSibling, getPrimaryClipboard, getRealized, getReceivesDefault, getRequestMode, getRoot, getScaleFactor, getSensitive, getSettings, getSize, getSizeRequest, getStateFlags, getStyleContext, getTemplateChild, getTooltipMarkup, getTooltipText, getValign, getVexpand, getVexpandSet, getVisible, getWidth, grabFocus, hasCssClass, hasDefault, hasFocus, hasVisibleFocus, hide, inDestruction, initTemplate, insertActionGroup, insertAfter, insertBefore, isAncestor, isDrawable, isFocus, isSensitive, isVisible, keynavFailed, listMnemonicLabels, map, measure, mnemonicActivate, moveFocus, observeChildren, observeControllers, onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, pick, pick, queryTooltip, queueAllocate, queueDraw, queueResize, realize, removeController, removeCssClass, removeMnemonicLabel, removeTickCallback, root, setCanFocus, setCanTarget, setChildVisible, setCssClasses, setCursor, setCursorFromName, setDefaultDirection, setDirection, setFocusable, setFocusChild, setFocusOnClick, setFontMap, setFontOptions, setHalign, setHasTooltip, setHexpand, setHexpandSet, setLayoutManager, setLimitEvents, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setParent, setReceivesDefault, setSensitive, setSizeRequest, setStateFlags, setStateFlags, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, shouldLayout, show, sizeAllocate, sizeAllocate, snapshot, snapshotChild, stateFlagsChanged, systemSettingChanged, translateCoordinates, triggerTooltipQuery, unmap, unparent, unrealize, unroot, unsetStateFlags, unsetStateFlags

Methods inherited from class org.gnome.gobject.GObject

addToggleRef, addWeakPointer, bindProperty, bindProperty, bindProperty, bindPropertyFull, bindPropertyFull, bindPropertyWithClosures, bindPropertyWithClosures, compatControl, connect, connect, connect, constructed, disconnect, dispatchPropertiesChanged, dispose, dupData, dupQdata, emit, emitNotify, finalize_, forceFloating, freezeNotify, get, getData, getProperty, getProperty, getProperty, getQdata, getv, interfaceFindProperty, interfaceInstallProperty, interfaceListProperties, isFloating, newInstance, newInstance, newv, notify, notify, notifyByPspec, onNotify, ref, refSink, removeToggleRef, removeWeakPointer, replaceData, replaceQdata, runDispose, set, setData, setDataFull, setProperty, setProperty, setProperty, setQdata, setQdataFull, setv, stealData, stealQdata, takeRef, thawNotify, unref, watchClosure, weakRef, weakUnref, withProperties

Methods inherited from class org.gnome.gobject.TypeInstance

callParent, callParent, cast, getPrivate, readGClass, writeGClass

Methods inherited from class org.javagi.base.ProxyInstance

equals, handle, hashCode

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gnome.gtk.Accessible

announce, getAccessibleParent, getAccessibleRole, getAtContext, getBounds, getFirstAccessibleChild, getNextAccessibleSibling, getPlatformState, resetProperty, resetRelation, resetState, setAccessibleParent, updateNextAccessibleSibling, updatePlatformState, updateProperty, updateRelation, updateState

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface org.gnome.gtk.Orientable

getOrientation, setOrientation

Methods inherited from interface org.javagi.base.Proxy

handle

Methods inherited from interface org.gnome.adw.Swipeable

getCancelProgress, getDistance, getProgress, getSnapPoints, getSwipeArea

Constructor Details

Leaflet

public Leaflet(MemorySegment address)

Deprecated.

Create a Leaflet proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

Leaflet

public Leaflet()

Deprecated.

Creates a new Leaflet.

Method Details

getType

public static @Nullable Type getType()

Deprecated.

Get the GType of the Leaflet class

Returns:

the GType

asParent

protected Leaflet asParent()

Deprecated.

Returns this instance as if it were its parent type. This is mostly synonymous to the Java super keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" with super.methodName() doesn't work, because it invokes the overridden function pointer again. To chain up, call asParent().methodName(). This will call the native function pointer of this virtual method in the typeclass of the parent type.

Overrides:

asParent in class Widget

append

@Deprecated
public LeafletPage append(Widget child)

Deprecated.

See the migration guide

Adds a child to self.

Parameters:

child - the widget to add

Returns:

the LeafletPage for child

getAdjacentChild

@Deprecated
public @Nullable Widget getAdjacentChild(NavigationDirection direction)

Deprecated.

See the migration guide

Finds the previous or next navigatable child.

This will be the same child navigate(org.gnome.adw.NavigationDirection) or swipe gestures will navigate to.

If there's no child to navigate to, NULL will be returned instead.

See LeafletPage:navigatable.

Parameters:

direction - the direction

Returns:

the previous or next child

getCanNavigateBack

@Deprecated
public boolean getCanNavigateBack()

Deprecated.

See the migration guide

Gets whether gestures and shortcuts for navigating backward are enabled.

Returns:

Whether gestures and shortcuts are enabled.

getCanNavigateForward

@Deprecated
public boolean getCanNavigateForward()

Deprecated.

See the migration guide

Gets whether gestures and shortcuts for navigating forward are enabled.

Returns:

Whether gestures and shortcuts are enabled.

getCanUnfold

@Deprecated
public boolean getCanUnfold()

Deprecated.

See the migration guide

Gets whether this Leaflet can unfold.

Returns:

whether this Leaflet can unfold

getChildByName

@Deprecated
public @Nullable Widget getChildByName(String name)

Deprecated.

See the migration guide

Finds the child of this Leaflet with name.

Returns NULL if there is no child with this name.

See LeafletPage:name.

Parameters:

name - the name of the child to find

Returns:

the requested child of this Leaflet

getChildTransitionParams

@Deprecated
public SpringParams getChildTransitionParams()

Deprecated.

See the migration guide

Gets the child transition spring parameters for self.

Returns:

the child transition parameters

getChildTransitionRunning

@Deprecated
public boolean getChildTransitionRunning()

Deprecated.

See the migration guide

Gets whether a child transition is currently running for self.

Returns:

whether a transition is currently running

getFoldThresholdPolicy

@Deprecated
public FoldThresholdPolicy getFoldThresholdPolicy()

Deprecated.

See the migration guide

Gets the fold threshold policy for self.

Returns:

the fold threshold policy

getFolded

@Deprecated
public boolean getFolded()

Deprecated.

See the migration guide

Gets whether this Leaflet is folded.

The leaflet will be folded if the size allocated to it is smaller than the sum of the minimum or natural sizes of the children (see Leaflet:fold-threshold-policy), it will be unfolded otherwise.

Returns:

whether this Leaflet is folded.

getHomogeneous

@Deprecated
public boolean getHomogeneous()

Deprecated.

See the migration guide

Gets whether this Leaflet is homogeneous.

Returns:

whether this Leaflet is homogeneous

getModeTransitionDuration

@Deprecated
public int getModeTransitionDuration()

Deprecated.

See the migration guide

Gets the mode transition animation duration for self.

Returns:

the mode transition duration, in milliseconds.

getPage

@Deprecated
public LeafletPage getPage(Widget child)

Deprecated.

See the migration guide

Returns the LeafletPage object for child.

Parameters:

child - a child of this Leaflet

Returns:

the page object for child

getPages

@Deprecated
public SelectionModel getPages()

Deprecated.

See the migration guide

Returns a ListModel that contains the pages of the leaflet.

This can be used to keep an up-to-date view. The model also implements SelectionModel and can be used to track and change the visible page.

Returns:

a GtkSelectionModel for the leaflet's children

getTransitionType

@Deprecated
public LeafletTransitionType getTransitionType()

Deprecated.

See the migration guide

Gets the type of animation used for transitions between modes and children.

Returns:

the current transition type of this Leaflet

getVisibleChild

@Deprecated
public @Nullable Widget getVisibleChild()

Deprecated.

See the migration guide

Gets the widget currently visible when the leaflet is folded.

Returns:

the visible child

getVisibleChildName

@Deprecated
public @Nullable String getVisibleChildName()

Deprecated.

See the migration guide

Gets the name of the currently visible child widget.

Returns:

the name of the visible child

insertChildAfter

@Deprecated
public LeafletPage insertChildAfter(Widget child,
 @Nullable Widget sibling)

Deprecated.

See the migration guide

Inserts child in the position after sibling in the list of children.

If sibling is NULL, inserts child at the first position.

Parameters:

child - the widget to insert

sibling - the sibling after which to insert child

Returns:

the LeafletPage for child

navigate

@Deprecated
public boolean navigate(NavigationDirection direction)

Deprecated.

See the migration guide

Navigates to the previous or next child.

The child must have the LeafletPage:navigatable property set to TRUE, otherwise it will be skipped.

This will be the same child as returned by getAdjacentChild(org.gnome.adw.NavigationDirection) or navigated to via swipe gestures.

Parameters:

direction - the direction

Returns:

whether the visible child was changed

prepend

@Deprecated
public LeafletPage prepend(Widget child)

Deprecated.

See the migration guide

Inserts child at the first position in self.

Parameters:

child - the widget to prepend

Returns:

the LeafletPage for child

remove

@Deprecated
public void remove(Widget child)

Deprecated.

See the migration guide

Removes a child widget from self.

Parameters:

child - the child to remove

reorderChildAfter

@Deprecated
public void reorderChildAfter(Widget child,
 @Nullable Widget sibling)

Deprecated.

See the migration guide

Moves child to the position after sibling in the list of children.

If sibling is NULL, moves child to the first position.

Parameters:

child - the widget to move, must be a child of this Leaflet

sibling - the sibling to move child after

setCanNavigateBack

@Deprecated
public void setCanNavigateBack(boolean canNavigateBack)

Deprecated.

See the migration guide

Sets whether gestures and shortcuts for navigating backward are enabled.

The supported gestures are:

• One-finger swipe on touchscreens
• Horizontal scrolling on touchpads (usually two-finger swipe)
• Back/forward mouse buttons

The keyboard back/forward keys are also supported, as well as the Alt+← shortcut for horizontal orientation, or Alt+↑ for vertical orientation.

If the orientation is horizontal, for right-to-left locales, gestures and shortcuts are reversed.

Only children that have LeafletPage:navigatable set to TRUE can be navigated to.

Parameters:

canNavigateBack - the new value

setCanNavigateForward

@Deprecated
public void setCanNavigateForward(boolean canNavigateForward)

Deprecated.

See the migration guide

Sets whether gestures and shortcuts for navigating forward are enabled.

The supported gestures are:

• One-finger swipe on touchscreens
• Horizontal scrolling on touchpads (usually two-finger swipe)
• Back/forward mouse buttons

The keyboard back/forward keys are also supported, as well as the Alt+→ shortcut for horizontal orientation, or Alt+↓ for vertical orientation.

If the orientation is horizontal, for right-to-left locales, gestures and shortcuts are reversed.

Only children that have LeafletPage:navigatable set to TRUE can be navigated to.

Parameters:

canNavigateForward - the new value

setCanUnfold

@Deprecated
public void setCanUnfold(boolean canUnfold)

Deprecated.

See the migration guide

Sets whether this Leaflet can unfold.

Parameters:

canUnfold - whether this Leaflet can unfold

setChildTransitionParams

@Deprecated
public void setChildTransitionParams(SpringParams params)

Deprecated.

See the migration guide

Sets the child transition spring parameters for self.

The default value is equivalent to:

adw_spring_params_new (1, 0.5, 500)
 

Parameters:

params - the new parameters

setFoldThresholdPolicy

@Deprecated
public void setFoldThresholdPolicy(FoldThresholdPolicy policy)

Deprecated.

See the migration guide

Sets the fold threshold policy for self.

If set to ADW_FOLD_THRESHOLD_POLICY_MINIMUM, it will only fold when the children cannot fit anymore. With ADW_FOLD_THRESHOLD_POLICY_NATURAL, it will fold as soon as children don't get their natural size.

This can be useful if you have a long ellipsizing label and want to let it ellipsize instead of immediately folding.

Parameters:

policy - the policy to use

setHomogeneous

@Deprecated
public void setHomogeneous(boolean homogeneous)

Deprecated.

See the migration guide

Sets this Leaflet to be homogeneous or not.

If set to FALSE, different children can have different size along the opposite orientation.

Parameters:

homogeneous - whether to make this Leaflet homogeneous

setModeTransitionDuration

@Deprecated
public void setModeTransitionDuration(int duration)

Deprecated.

See the migration guide

Sets the mode transition animation duration for self.

Parameters:

duration - the new duration, in milliseconds

setTransitionType

@Deprecated
public void setTransitionType(LeafletTransitionType transition)

Deprecated.

See the migration guide

Sets the type of animation used for transitions between modes and children.

The transition type can be changed without problems at runtime, so it is possible to change the animation based on the mode or child that is about to become current.

Parameters:

transition - the new transition type

setVisibleChild

@Deprecated
public void setVisibleChild(Widget visibleChild)

Deprecated.

See the migration guide

Sets the widget currently visible when the leaflet is folded.

The transition is determined by Leaflet:transition-type and Leaflet:child-transition-params. The transition can be cancelled by the user, in which case visible child will change back to the previously visible child.

Parameters:

visibleChild - the new child

setVisibleChildName

@Deprecated
public void setVisibleChildName(String name)

Deprecated.

See the migration guide

Makes the child with the name name visible.

See Leaflet:visible-child.

Parameters:

name - the name of a child

builder

public static Leaflet.Builder<? extends Leaflet.Builder> builder()

Deprecated.

A Leaflet.Builder object constructs a Leaflet with the specified properties. Use the various set...() methods to set properties, and finish construction with Leaflet.Builder.build().

Returns:

the builder object