Class ActionRow
- All Implemented Interfaces:
Proxy
,Accessible
,Actionable
,Buildable
,ConstraintTarget
ListBoxRow
used to present actions.
The AdwActionRow
widget can have a title, a subtitle and an icon. The row
can receive additional widgets at its end, or prefix widgets at its start.
It is convenient to present a preference and its related actions.
AdwActionRow
is unactivatable by default, giving it an activatable widget
will automatically make it activatable, but unsetting it won't change the
row's activatability.
AdwActionRow as GtkBuildable
The AdwActionRow
implementation of the Buildable
interface
supports adding a child at its end by specifying “suffix” or omitting the
“type” attribute of a <child> element.
It also supports adding a child as a prefix widget by specifying “prefix” as the “type” attribute of a <child> element.
CSS nodes
AdwActionRow
has a main CSS node with name row
.
It contains the subnode box.header
for its main horizontal box, and
box.title
for the vertical box containing the title and subtitle labels.
It contains subnodes label.title
and label.subtitle
representing
respectively the title label and subtitle label.
Style classes
AdwActionRow
can use the .property
style class to emphasize the row subtitle instead of the row title, which is
useful for displaying read-only properties.
When used together with the .monospace
style class, only the subtitle
becomes monospace, not the title or any extra widgets.
-
Nested Class Summary
Modifier and TypeClassDescriptionstatic class
static interface
Functional interface declaration of theActivatedCallback
callback.static class
ActionRow.Builder<B extends ActionRow.Builder<B>>
Inner class implementing a builder pattern to construct a GObject with properties.Nested classes/interfaces inherited from class org.gnome.adw.PreferencesRow
PreferencesRow.PreferencesRowClass
Nested classes/interfaces inherited from class org.gnome.gtk.ListBoxRow
ListBoxRow.ActivateCallback, ListBoxRow.ListBoxRowClass
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.Actionable
Actionable.ActionableImpl, Actionable.ActionableInterface
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
ConstructorDescriptionCreates a newAdwActionRow
.ActionRow
(MemorySegment address) Create a ActionRow proxy instance for the provided memory address. -
Method Summary
Modifier and TypeMethodDescriptionvoid
activate()
Activates this ActionRow.void
Adds a prefix widget to this ActionRow.void
Adds a suffix widget to this ActionRow.protected ActionRow
asParent()
Returns this instance as if it were its parent type.static ActionRow.Builder
<? extends ActionRow.Builder> builder()
AActionRow.Builder
object constructs aActionRow
with the specified properties.void
Emits the "activated" signal.Gets the widget activated when this ActionRow is activated.Deprecated.static MemoryLayout
The memory layout of the native struct.Gets the subtitle for this ActionRow.int
Gets the number of lines at the end of which the subtitle label will be ellipsized.boolean
Gets whether the user can copy the subtitle from the labelint
Gets the number of lines at the end of which the title label will be ellipsized.static Type
getType()
Get the GType of the ActionRow classonActivated
(ActionRow.ActivatedCallback handler) This signal is emitted after the row has been activated.void
Removes a child from this ActionRow.void
setActivatableWidget
(@Nullable Widget widget) Sets the widget to activate when this ActionRow is activated.void
setIconName
(@Nullable String iconName) Deprecated.UseaddPrefix(org.gnome.gtk.Widget)
to add an icon.void
setSubtitle
(String subtitle) Sets the subtitle for this ActionRow.void
setSubtitleLines
(int subtitleLines) Sets the number of lines at the end of which the subtitle label will be ellipsized.void
setSubtitleSelectable
(boolean subtitleSelectable) Sets whether the user can copy the subtitle from the labelvoid
setTitleLines
(int titleLines) Sets the number of lines at the end of which the title label will be ellipsized.Methods inherited from class org.gnome.adw.PreferencesRow
getTitle, getTitleSelectable, getUseMarkup, getUseUnderline, setTitle, setTitleSelectable, setUseMarkup, setUseUnderline
Methods inherited from class org.gnome.gtk.ListBoxRow
changed, emitActivate, getActivatable, getChild, getHeader, getIndex, getSelectable, isSelected, onActivate, setActivatable, setChild, setHeader, setSelectable
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, 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.Actionable
getActionName, getActionTargetValue, setActionName, setActionTarget, setActionTargetValue, setDetailedActionName
Methods inherited from interface org.gnome.gtk.Buildable
getBuildableId
-
Constructor Details
-
Method Details
-
getType
-
getMemoryLayout
The memory layout of the native struct.- Returns:
- the memory layout
-
asParent
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.- Overrides:
asParent
in classPreferencesRow
-
activate
-
addPrefix
Adds a prefix widget to this ActionRow.- Parameters:
widget
- a widget
-
addSuffix
Adds a suffix widget to this ActionRow.- Parameters:
widget
- a widget
-
getActivatableWidget
Gets the widget activated when this ActionRow is activated.- Returns:
- the activatable widget for this ActionRow
-
getIconName
Deprecated.UseaddPrefix(org.gnome.gtk.Widget)
to add an icon.Gets the icon name for this ActionRow.- Returns:
- the icon name for this ActionRow
-
getSubtitle
Gets the subtitle for this ActionRow.- Returns:
- the subtitle for this ActionRow
-
getSubtitleLines
public int getSubtitleLines()Gets the number of lines at the end of which the subtitle label will be ellipsized.- Returns:
- the number of lines at the end of which the subtitle label will be ellipsized
-
getSubtitleSelectable
public boolean getSubtitleSelectable()Gets whether the user can copy the subtitle from the label- Returns:
- whether the user can copy the subtitle from the label
-
getTitleLines
public int getTitleLines()Gets the number of lines at the end of which the title label will be ellipsized.- Returns:
- the number of lines at the end of which the title label will be ellipsized
-
remove
Removes a child from this ActionRow.- Parameters:
widget
- the child to be removed
-
setActivatableWidget
Sets the widget to activate when this ActionRow is activated.The row can be activated either by clicking on it, calling
activate()
, or via mnemonics in the title. See thePreferencesRow:use-underline
property to enable mnemonics.The target widget will be activated by emitting the
Gtk.Widget::mnemonic-activate
signal on it.- Parameters:
widget
- the target widget
-
setIconName
Deprecated.UseaddPrefix(org.gnome.gtk.Widget)
to add an icon.Sets the icon name for this ActionRow.- Parameters:
iconName
- the icon name
-
setSubtitle
Sets the subtitle for this ActionRow.The subtitle is interpreted as Pango markup unless
PreferencesRow:use-markup
is set toFALSE
.- Parameters:
subtitle
- the subtitle
-
setSubtitleLines
public void setSubtitleLines(int subtitleLines) Sets the number of lines at the end of which the subtitle label will be ellipsized.If the value is 0, the number of lines won't be limited.
- Parameters:
subtitleLines
- the number of lines at the end of which the subtitle label will be ellipsized
-
setSubtitleSelectable
public void setSubtitleSelectable(boolean subtitleSelectable) Sets whether the user can copy the subtitle from the labelSee also
Gtk.Label:selectable
.- Parameters:
subtitleSelectable
-TRUE
if the user can copy the subtitle from the label
-
setTitleLines
public void setTitleLines(int titleLines) Sets the number of lines at the end of which the title label will be ellipsized.If the value is 0, the number of lines won't be limited.
- Parameters:
titleLines
- the number of lines at the end of which the title label will be ellipsized
-
onActivated
public SignalConnection<ActionRow.ActivatedCallback> onActivated(ActionRow.ActivatedCallback handler) This signal is emitted after the row has been activated.- Parameters:
handler
- the signal handler- Returns:
- a signal handler ID to keep track of the signal connection
- See Also:
-
emitActivated
public void emitActivated()Emits the "activated" signal. SeeonActivated(org.gnome.adw.ActionRow.ActivatedCallback)
. -
builder
AActionRow.Builder
object constructs aActionRow
with the specified properties. Use the variousset...()
methods to set properties, and finish construction withActionRow.Builder.build()
.
-
addPrefix(org.gnome.gtk.Widget)
to add an icon.