Package org.gnome.adw

Class ToolbarView

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.ToolbarView

All Implemented Interfaces:

Accessible, Buildable, ConstraintTarget, Proxy

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

A widget containing a page, as well as top and/or bottom bars.

AdwToolbarView has a single content widget and one or multiple top and bottom bars, shown at the top and bottom sides respectively.

Example of an AdwToolbarView UI definition:

<object class="AdwToolbarView">
   <child type="top">
     <object class="AdwHeaderBar"/>
   </child>
   <property name="content">
     <object class="AdwPreferencesPage">
       <!-- ... -->
     </object>
   </property>
 </object>
 

The following kinds of top and bottom bars are supported:

• HeaderBar
• TabBar
• ViewSwitcherBar
• ActionBar
• HeaderBar
• PopoverMenuBar
• SearchBar
• Any Box or a similar widget with the .toolbar style class

By default, top and bottom bars are flat and scrolling content has a subtle undershoot shadow, same as when using the .undershoot-top and .undershoot-bottom style classes. This works well in most cases, e.g. with StatusPage or PreferencesPage, where the background at the top and bottom parts of the page is uniform. Additionally, windows with sidebars should always use this style.

ToolbarView:top-bar-style and ToolbarView:bottom-bar-style properties can be used add an opaque background and a persistent shadow to top and bottom bars, this can be useful for content such as utility panes, where some elements are adjacent to the top/bottom bars, or TabView, where each page can have a different background.

AdwToolbarView ensures the top and bottom bars have consistent backdrop styles and vertical spacing. For comparison:

Any top and bottom bars can also be dragged to move the window, equivalent to putting them into a WindowHandle.

Content is typically place between top and bottom bars, but can also extend behind them. This is controlled with the ToolbarView:extend-content-to-top-edge and ToolbarView:extend-content-to-bottom-edge properties.

Top and bottom bars can be hidden and revealed with an animation using the ToolbarView:reveal-top-bars and ToolbarView:reveal-bottom-bars properties.

AdwToolbarView as GtkBuildable
The AdwToolbarView implementation of the Buildable interface supports adding a top bar by specifying “top” as the “type” attribute of a <child> element, or adding a bottom bar by specifying “bottom”.

Accessibility
AdwToolbarView uses the GTK_ACCESSIBLE_ROLE_GROUP role.

Since:

1.4

Nested Class Summary

Nested Classes

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

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	addBottomBar(Widget widget)	Adds a bottom bar to self.
void	addTopBar(Widget widget)	Adds a top bar to self.
protected ToolbarView	asParent()	Returns this instance as if it were its parent type.
static ToolbarView.Builder<? extends ToolbarView.Builder>	builder()	A ToolbarView.Builder object constructs a ToolbarView with the specified properties.
int	getBottomBarHeight()	Gets the current bottom bar height for self.
ToolbarStyle	getBottomBarStyle()	Gets appearance of the bottom bars for self.
@Nullable Widget	getContent()	Gets the content widget for self.
boolean	getExtendContentToBottomEdge()	Gets whether the content widget can extend behind bottom bars.
boolean	getExtendContentToTopEdge()	Gets whether the content widget can extend behind top bars.
boolean	getRevealBottomBars()	Gets whether bottom bars are revealed for self.
boolean	getRevealTopBars()	Gets whether top bars are revealed for self.
int	getTopBarHeight()	Gets the current top bar height for self.
ToolbarStyle	getTopBarStyle()	Gets appearance of the top bars for self.
static @Nullable Type	getType()	Get the GType of the ToolbarView class
void	remove(Widget widget)	Removes a child from self.
void	setBottomBarStyle(ToolbarStyle style)	Sets appearance of the bottom bars for self.
void	setContent(@Nullable Widget content)	Sets the content widget for self.
void	setExtendContentToBottomEdge(boolean extend)	Sets whether the content widget can extend behind bottom bars.
void	setExtendContentToTopEdge(boolean extend)	Sets whether the content widget can extend behind top bars.
void	setRevealBottomBars(boolean reveal)	Sets whether bottom bars are revealed for self.
void	setRevealTopBars(boolean reveal)	Sets whether top bars are revealed for self.
void	setTopBarStyle(ToolbarStyle style)	Sets appearance of the top bars for self.

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.javagi.base.Proxy

handle

Constructor Details

ToolbarView

public ToolbarView(MemorySegment address)

Create a ToolbarView proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

ToolbarView

public ToolbarView()

Creates a new ToolbarView.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the ToolbarView class

Returns:

the GType

asParent

protected ToolbarView asParent()

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

addBottomBar

public void addBottomBar(Widget widget)

Adds a bottom bar to self.

Parameters:

widget - a widget

Since:

1.4

addTopBar

public void addTopBar(Widget widget)

Adds a top bar to self.

Parameters:

widget - a widget

Since:

1.4

getBottomBarHeight

public int getBottomBarHeight()

Gets the current bottom bar height for self.

Bottom bar height does change depending on ToolbarView:reveal-bottom-bars, including during the transition.

See getTopBarHeight().

Returns:

the current bottom bar height

Since:

1.4

getBottomBarStyle

public ToolbarStyle getBottomBarStyle()

Gets appearance of the bottom bars for self.

Returns:

bottom bar style

Since:

1.4

getContent

public @Nullable Widget getContent()

Gets the content widget for self.

Returns:

the content widget

Since:

1.4

getExtendContentToBottomEdge

public boolean getExtendContentToBottomEdge()

Gets whether the content widget can extend behind bottom bars.

Returns:

whether content extends behind bottom bars

Since:

1.4

getExtendContentToTopEdge

public boolean getExtendContentToTopEdge()

Gets whether the content widget can extend behind top bars.

Returns:

whether content extends behind top bars

Since:

1.4

getRevealBottomBars

public boolean getRevealBottomBars()

Gets whether bottom bars are revealed for self.

Returns:

whether bottom bars are revealed

Since:

1.4

getRevealTopBars

public boolean getRevealTopBars()

Gets whether top bars are revealed for self.

Returns:

whether top bars are revealed

Since:

1.4

getTopBarHeight

public int getTopBarHeight()

Gets the current top bar height for self.

Top bar height does change depending on ToolbarView:reveal-top-bars, including during the transition.

See getBottomBarHeight().

Returns:

the current top bar height

Since:

1.4

getTopBarStyle

public ToolbarStyle getTopBarStyle()

Gets appearance of the top bars for self.

Returns:

top bar style

Since:

1.4

remove

public void remove(Widget widget)

Removes a child from self.

Parameters:

widget - the child to be removed

Since:

1.4

setBottomBarStyle

public void setBottomBarStyle(ToolbarStyle style)

Sets appearance of the bottom bars for self.

If set to ADW_TOOLBAR_FLAT, bottom bars are flat and scrolling content has a subtle undershoot shadow when touching them, same as the .undershoot-bottom style class. This works well for simple content, e.g. StatusPage or PreferencesPage, where the background at the bottom of the page is uniform. Additionally, windows with sidebars should always use this style.

Undershoot shadow is only present if a bottom bar is actually present and visible. It is also never present if ToolbarView:extend-content-to-bottom-edge is set to TRUE.

If set to ADW_TOOLBAR_RAISED, bottom bars have an opaque background and a persistent shadow, this is suitable for content such as utility panes, where some elements are directly adjacent to the bottom bars, or TabView, where each page can have a different background.

ADW_TOOLBAR_RAISED_BORDER is similar to ADW_TOOLBAR_RAISED, but the shadow is replaced with a more subtle border. This can be useful for applications like image viewers.

See also setTopBarStyle(org.gnome.adw.ToolbarStyle).

Parameters:

style - bottom bar style

Since:

1.4

setContent

public void setContent(@Nullable Widget content)

Sets the content widget for self.

Parameters:

content - the content widget

Since:

1.4

setExtendContentToBottomEdge

public void setExtendContentToBottomEdge(boolean extend)

Sets whether the content widget can extend behind bottom bars.

This can be used in combination with ToolbarView:reveal-bottom-bars to show and hide toolbars in fullscreen.

See setExtendContentToTopEdge(boolean).

Parameters:

extend - whether content extends behind bottom bars

Since:

1.4

setExtendContentToTopEdge

public void setExtendContentToTopEdge(boolean extend)

Sets whether the content widget can extend behind top bars.

This can be used in combination with ToolbarView:reveal-top-bars to show and hide toolbars in fullscreen.

See setExtendContentToBottomEdge(boolean).

Parameters:

extend - whether content extends behind top bars

Since:

1.4

setRevealBottomBars

public void setRevealBottomBars(boolean reveal)

Sets whether bottom bars are revealed for self.

The transition will be animated.

This can be used in combination with ToolbarView:extend-content-to-bottom-edge to show and hide toolbars in fullscreen.

See setRevealTopBars(boolean).

Parameters:

reveal - whether to reveal bottom bars

Since:

1.4

setRevealTopBars

public void setRevealTopBars(boolean reveal)

Sets whether top bars are revealed for self.

The transition will be animated.

This can be used in combination with ToolbarView:extend-content-to-top-edge to show and hide toolbars in fullscreen.

See setRevealBottomBars(boolean).

Parameters:

reveal - whether to reveal top bars

Since:

1.4

setTopBarStyle

public void setTopBarStyle(ToolbarStyle style)

Sets appearance of the top bars for self.

If set to ADW_TOOLBAR_FLAT, top bars are flat and scrolling content has a subtle undershoot shadow when touching them, same as the .undershoot-top style class. This works well for simple content, e.g. StatusPage or PreferencesPage, where the background at the top of the page is uniform. Additionally, windows with sidebars should always use this style.

Undershoot shadow is only present if a top bar is actually present and visible. It is also never present if ToolbarView:extend-content-to-top-edge is set to TRUE.

If set to ADW_TOOLBAR_RAISED, top bars have an opaque background and a persistent shadow, this is suitable for content such as utility panes, where some elements are directly adjacent to the top bars, or TabView, where each page can have a different background.

ADW_TOOLBAR_RAISED_BORDER is similar to ADW_TOOLBAR_RAISED, but the shadow is replaced with a more subtle border. This can be useful for applications like image viewers.

See also setBottomBarStyle(org.gnome.adw.ToolbarStyle).

Parameters:

style - top bar style

Since:

1.4

builder

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

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

Returns:

the builder object