Class ViewSwitcherTitle
- All Implemented Interfaces:
Proxy
,Accessible
,Buildable
,ConstraintTarget
A widget letting you switch between multiple views contained by a
ViewStack
via an ViewSwitcher
.
It is designed to be used as the title widget of a HeaderBar
, and
will display the window's title when the window is too narrow to fit the view
switcher e.g. on mobile phones, or if there are less than two views.
In order to center the title in narrow windows, the header bar should have
HeaderBar:centering-policy
set to
ADW_CENTERING_POLICY_STRICT
.
AdwViewSwitcherTitle
is intended to be used together with
ViewSwitcherBar
.
A common use case is to bind the ViewSwitcherBar:reveal
property
to ViewSwitcherTitle:title-visible
to automatically reveal the
view switcher bar when the title label is displayed in place of the view
switcher, as follows:
<object class="AdwWindow">
<property name="content">
<object class="AdwToolbarView">
<child type="top">
<object class="AdwHeaderBar">
<property name="centering-policy">strict</property>
<property name="title-widget">
<object class="AdwViewSwitcherTitle" id="title">
<property name="stack">stack</property>
</object>
</property>
</object>
</child>
<property name="content">
<object class="AdwViewStack" id="stack"/>
</property>
<child type="bottom">
<object class="AdwViewSwitcherBar">
<property name="stack">stack</property>
<binding name="reveal">
<lookup name="title-visible">title</lookup>
</binding>
</object>
</child>
</object>
</property>
</object>
CSS nodes
AdwViewSwitcherTitle
has a single CSS node with name viewswitchertitle
.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
ViewSwitcherTitle.Builder<B extends ViewSwitcherTitle.Builder<B>>
Deprecated.Inner class implementing a builder pattern to construct a GObject with properties.static class
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.WidgetClass, Widget.WidgetImpl
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.AccessibleImpl, Accessible.AccessibleInterface
Nested classes/interfaces inherited from interface org.gnome.gtk.Buildable
Buildable.BuildableIface, Buildable.BuildableImpl
Nested classes/interfaces inherited from interface org.gnome.gtk.ConstraintTarget
ConstraintTarget.ConstraintTargetImpl, ConstraintTarget.ConstraintTargetInterface
-
Constructor Summary
ConstructorDescriptionDeprecated.See the migration guideViewSwitcherTitle
(MemorySegment address) Deprecated.Create a ViewSwitcherTitle proxy instance for the provided memory address. -
Method Summary
Modifier and TypeMethodDescriptionprotected ViewSwitcherTitle
asParent()
Deprecated.Returns this instance as if it were its parent type.static ViewSwitcherTitle.Builder
<? extends ViewSwitcherTitle.Builder> builder()
Deprecated.AViewSwitcherTitle.Builder
object constructs aViewSwitcherTitle
with the specified properties.getStack()
Deprecated.Deprecated.getTitle()
Deprecated.boolean
Deprecated.static Type
getType()
Deprecated.Get the GType of the ViewSwitcherTitle classboolean
Deprecated.void
Deprecated.void
setSubtitle
(String subtitle) Deprecated.void
Deprecated.void
setViewSwitcherEnabled
(boolean enabled) Deprecated.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, 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, 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, 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, getPrivate, readGClass, writeGClass
Methods inherited from class io.github.jwharm.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, updateProperty, updateRelation, updateState
Methods inherited from interface org.gnome.gtk.Buildable
getBuildableId
-
Constructor Details
-
ViewSwitcherTitle
Deprecated.Create a ViewSwitcherTitle proxy instance for the provided memory address.- Parameters:
address
- the memory address of the native object
-
ViewSwitcherTitle
Deprecated.Creates a newAdwViewSwitcherTitle
.
-
-
Method Details
-
getType
Deprecated.Get the GType of the ViewSwitcherTitle class- Returns:
- the GType
-
asParent
Deprecated.Returns this instance as if it were its parent type. This is mostly synonymous to the Javasuper
keyword, but will set the native typeclass function pointers to the parent type. When overriding a native virtual method in Java, "chaining up" withsuper.methodName()
doesn't work, because it invokes the overridden function pointer again. To chain up, callasParent().methodName()
. This will call the native function pointer of this virtual method in the typeclass of the parent type. -
getStack
Deprecated.Gets the stack controlled by this ViewSwitcherTitle.- Returns:
- the stack
-
getSubtitle
Deprecated.Gets the subtitle of this ViewSwitcherTitle.- Returns:
- the subtitle
-
getTitle
Deprecated.Gets the title of this ViewSwitcherTitle.- Returns:
- the title
-
getTitleVisible
Deprecated.Gets whether the title of this ViewSwitcherTitle is currently visible.If the title is visible, it means the view switcher is hidden an it may be wanted to show an alternative switcher, e.g. a
ViewSwitcherBar
.- Returns:
- whether the title of this ViewSwitcherTitle is currently visible
-
getViewSwitcherEnabled
Deprecated.Gets whether this ViewSwitcherTitle's view switcher is enabled.- Returns:
- whether the view switcher is enabled
-
setStack
Deprecated.Sets the stack controlled by this ViewSwitcherTitle.- Parameters:
stack
- a stack
-
setSubtitle
Deprecated.Sets the subtitle of this ViewSwitcherTitle.The subtitle should give the user additional details.
- Parameters:
subtitle
- a subtitle
-
setTitle
Deprecated.Sets the title of this ViewSwitcherTitle.The title typically identifies the current view or content item, and generally does not use the application name.
- Parameters:
title
- a title
-
setViewSwitcherEnabled
Deprecated.Sets whether this ViewSwitcherTitle's view switcher is enabled.If it is disabled, the title will be displayed instead. This allows to programmatically hide the view switcher even if it fits in the available space.
This can be used e.g. to ensure the view switcher is hidden below a certain window width, or any other constraint you find suitable.
- Parameters:
enabled
- whether the view switcher is enabled
-
builder
Deprecated.AViewSwitcherTitle.Builder
object constructs aViewSwitcherTitle
with the specified properties. Use the variousset...()
methods to set properties, and finish construction withViewSwitcherTitle.Builder.build()
.
-