Package org.gnome.adw

Class ActionRow

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.gtk.ListBoxRow

org.gnome.adw.PreferencesRow

org.gnome.adw.ActionRow

All Implemented Interfaces:

Accessible, Actionable, Buildable, ConstraintTarget, Proxy

Direct Known Subclasses:

ComboRow, SpinRow, SwitchRow

@Generated("io.github.jwharm.JavaGI")
public class ActionRow
extends PreferencesRow
implements Accessible, Actionable, Buildable, ConstraintTarget

A 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

Nested Classes

Modifier and Type	Class	Description
static class	ActionRow.ActionRowClass
static interface	ActionRow.ActivatedCallback	Functional interface declaration of the ActivatedCallback 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.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.Actionable

Actionable.Actionable$Impl, Actionable.ActionableInterface

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
ActionRow()	Creates a new ActionRow.
ActionRow(MemorySegment address)	Create a ActionRow proxy instance for the provided memory address.

Method Summary

Modifier and Type	Method	Description
void	activate()	Activates self.
void	addPrefix(Widget widget)	Adds a prefix widget to self.
void	addSuffix(Widget widget)	Adds a suffix widget to self.
protected ActionRow	asParent()	Returns this instance as if it were its parent type.
static ActionRow.Builder<? extends ActionRow.Builder>	builder()	A ActionRow.Builder object constructs a ActionRow with the specified properties.
void	emitActivated()	Emits the "activated" signal.
@Nullable Widget	getActivatableWidget()	Gets the widget activated when this ActionRow is activated.
@Nullable String	getIconName()	Deprecated. Use addPrefix(org.gnome.gtk.Widget) to add an icon.
static MemoryLayout	getMemoryLayout()	The memory layout of the native struct.
@Nullable String	getSubtitle()	Gets the subtitle for self.
int	getSubtitleLines()	Gets the number of lines at the end of which the subtitle label will be ellipsized.
boolean	getSubtitleSelectable()	Gets whether the user can copy the subtitle from the label
int	getTitleLines()	Gets the number of lines at the end of which the title label will be ellipsized.
static @Nullable Type	getType()	Get the GType of the ActionRow class
SignalConnection<ActionRow.ActivatedCallback>	onActivated(ActionRow.ActivatedCallback handler)	This signal is emitted after the row has been activated.
void	remove(Widget widget)	Removes a child from self.
void	setActivatableWidget(@Nullable Widget widget)	Sets the widget to activate when this ActionRow is activated.
void	setIconName(@Nullable String iconName)	Deprecated. Use addPrefix(org.gnome.gtk.Widget) to add an icon.
void	setSubtitle(String subtitle)	Sets the subtitle for self.
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 label
void	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, getLimitEvents, 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, 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.Actionable

getActionName, getActionTargetValue, setActionName, setActionTarget, setActionTargetValue, setDetailedActionName

Methods inherited from interface org.gnome.gtk.Buildable

getBuildableId

Methods inherited from interface org.javagi.base.Proxy

handle

Constructor Details

ActionRow

public ActionRow(MemorySegment address)

Create a ActionRow proxy instance for the provided memory address.

Parameters:

address - the memory address of the native object

ActionRow

public ActionRow()

Creates a new ActionRow.

Method Details

getType

public static @Nullable Type getType()

Get the GType of the ActionRow class

Returns:

the GType

getMemoryLayout

public static MemoryLayout getMemoryLayout()

The memory layout of the native struct.

Returns:

the memory layout

asParent

protected ActionRow 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 PreferencesRow

activate

public void activate()

Activates self.

Overrides:

activate in class ListBoxRow

addPrefix

public void addPrefix(Widget widget)

Adds a prefix widget to self.

Parameters:

widget - a widget

addSuffix

public void addSuffix(Widget widget)

Adds a suffix widget to self.

Parameters:

widget - a widget

getActivatableWidget

public @Nullable Widget getActivatableWidget()

Gets the widget activated when this ActionRow is activated.

Returns:

the activatable widget for this ActionRow

getIconName

@Deprecated
public @Nullable String getIconName()

Deprecated.

Use addPrefix(org.gnome.gtk.Widget) to add an icon.

Gets the icon name for self.

Returns:

the icon name for this ActionRow

getSubtitle

public @Nullable String getSubtitle()

Gets the subtitle for self.

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

Since:

1.3

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

public void remove(Widget widget)

Removes a child from self.

Parameters:

widget - the child to be removed

setActivatableWidget

public void setActivatableWidget(@Nullable Widget widget)

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 the PreferencesRow: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
public void setIconName(@Nullable String iconName)

Deprecated.

Use addPrefix(org.gnome.gtk.Widget) to add an icon.

Sets the icon name for self.

Parameters:

iconName - the icon name

setSubtitle

public void setSubtitle(String subtitle)

Sets the subtitle for self.

The subtitle is interpreted as Pango markup unless PreferencesRow:use-markup is set to FALSE.

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 label

See also Gtk.Label:selectable.

Parameters:

subtitleSelectable - TRUE if the user can copy the subtitle from the label

Since:

1.3

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:

• ActionRow.ActivatedCallback.run()

emitActivated

public void emitActivated()

Emits the "activated" signal. See onActivated(org.gnome.adw.ActionRow.ActivatedCallback).

builder

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

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

Returns:

the builder object