Package org.gnome.gtk

Class ListBox.Builder<B extends ListBox.Builder<B>>

java.lang.Object

org.javagi.gobject.Builder<B>

org.gnome.gobject.GObject.Builder<B>

org.gnome.gobject.InitiallyUnowned.Builder<B>

org.gnome.gtk.Widget.Builder<B>

org.gnome.gtk.ListBox.Builder<B>

Type Parameters:

B - the type of the Builder that is returned

All Implemented Interfaces:

Accessible.Builder<B>, BuilderInterface

Enclosing class:

ListBox

public static class ListBox.Builder<B extends ListBox.Builder<B>>
extends Widget.Builder<B>
implements Accessible.Builder<B>

Inner class implementing a builder pattern to construct a GObject with properties.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Builder()	Default constructor for a Builder object.

Method Summary

Modifier and Type	Method	Description
ListBox	build()	Finish building the ListBox object.
B	onActivateCursorRow(ListBox.ActivateCursorRowCallback handler)	Emitted when the cursor row is activated.
B	onMoveCursor(ListBox.MoveCursorCallback handler)	Emitted when the user initiates a cursor movement.
B	onRowActivated(ListBox.RowActivatedCallback handler)	Emitted when a row has been activated by the user.
B	onRowSelected(ListBox.RowSelectedCallback handler)	Emitted when a new row is selected, or (with a null row) when the selection is cleared.
B	onSelectAll(ListBox.SelectAllCallback handler)	Emitted to select all children of the box, if the selection mode permits it.
B	onSelectedRowsChanged(ListBox.SelectedRowsChangedCallback handler)	Emitted when the set of selected rows changes.
B	onToggleCursorRow(ListBox.ToggleCursorRowCallback handler)	Emitted when the cursor row is toggled.
B	onUnselectAll(ListBox.UnselectAllCallback handler)	Emitted to unselect all children of the box, if the selection mode permits it.
B	setAcceptUnpairedRelease(boolean acceptUnpairedRelease)	Whether to accept unpaired release events.
B	setActivateOnSingleClick(boolean activateOnSingleClick)	Determines whether children can be activated with a single click, or require a double-click.
B	setSelectionMode(SelectionMode selectionMode)	The selection mode used by the list box.
B	setShowSeparators(boolean showSeparators)	Whether to show separators between rows.
B	setTabBehavior(ListTabBehavior tabBehavior)	Behavior of the Tab key

Methods inherited from class org.gnome.gtk.Widget.Builder

onDestroy, onDirectionChanged, onHide, onKeynavFailed, onMap, onMnemonicActivate, onMoveFocus, onQueryTooltip, onRealize, onShow, onStateFlagsChanged, onUnmap, onUnrealize, setCanFocus, setCanTarget, setCssClasses, setCssName, setCursor, setFocusable, setFocusOnClick, setHalign, setHasTooltip, setHeightRequest, setHexpand, setHexpandSet, setLayoutManager, setLimitEvents, setMarginBottom, setMarginEnd, setMarginStart, setMarginTop, setName, setOpacity, setOverflow, setReceivesDefault, setSensitive, setTooltipMarkup, setTooltipText, setValign, setVexpand, setVexpandSet, setVisible, setWidthRequest

Methods inherited from class org.gnome.gobject.GObject.Builder

onNotify

Methods inherited from class org.javagi.gobject.Builder

addBuilderProperty, connect, connect, connectSignals, getArena, getNames, getValues

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gnome.gtk.Accessible.Builder

setAccessibleRole

Methods inherited from interface org.javagi.gobject.BuilderInterface

addBuilderProperty, connect, connect, getArena

Constructor Details

Builder

protected Builder()

Default constructor for a Builder object.

Method Details

build

public ListBox build()

Finish building the ListBox object. This will call GObject.withProperties(org.gnome.glib.Type, java.lang.String[], org.gnome.gobject.Value[]) to create a new GObject instance, which is then cast to ListBox.

Overrides:

build in class Widget.Builder<B extends ListBox.Builder<B>>

Returns:

a new instance of ListBox with the properties that were set in the Builder object.

setAcceptUnpairedRelease

public B setAcceptUnpairedRelease(boolean acceptUnpairedRelease)

Whether to accept unpaired release events.

Parameters:

acceptUnpairedRelease - the value for the accept-unpaired-release property

Returns:

the Builder instance is returned, to allow method chaining

setActivateOnSingleClick

public B setActivateOnSingleClick(boolean activateOnSingleClick)

Determines whether children can be activated with a single click, or require a double-click.

Parameters:

activateOnSingleClick - the value for the activate-on-single-click property

Returns:

the Builder instance is returned, to allow method chaining

setSelectionMode

public B setSelectionMode(SelectionMode selectionMode)

The selection mode used by the list box.

Parameters:

selectionMode - the value for the selection-mode property

Returns:

the Builder instance is returned, to allow method chaining

setShowSeparators

public B setShowSeparators(boolean showSeparators)

Whether to show separators between rows.

Parameters:

showSeparators - the value for the show-separators property

Returns:

the Builder instance is returned, to allow method chaining

setTabBehavior

public B setTabBehavior(ListTabBehavior tabBehavior)

Behavior of the Tab key

Parameters:

tabBehavior - the value for the tab-behavior property

Returns:

the Builder instance is returned, to allow method chaining

Since:

4.18

onActivateCursorRow

public B onActivateCursorRow(ListBox.ActivateCursorRowCallback handler)

Emitted when the cursor row is activated.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.ActivateCursorRowCallback.run()

onMoveCursor

public B onMoveCursor(ListBox.MoveCursorCallback handler)

Emitted when the user initiates a cursor movement.

The default bindings for this signal come in two variants, the variant with the Shift modifier extends the selection, the variant without the Shift modifier does not. There are too many key combinations to list them all here.

• ←, →, ↑, ↓ move by individual children
• Home, End move to the ends of the box
• PgUp, PgDn move vertically by pages

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.MoveCursorCallback.run(org.gnome.gtk.MovementStep, int, boolean, boolean)

onRowActivated

public B onRowActivated(ListBox.RowActivatedCallback handler)

Emitted when a row has been activated by the user.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.RowActivatedCallback.run(org.gnome.gtk.ListBoxRow)

onRowSelected

public B onRowSelected(ListBox.RowSelectedCallback handler)

Emitted when a new row is selected, or (with a null row) when the selection is cleared.

When the box is using SelectionMode.MULTIPLE, this signal will not give you the full picture of selection changes, and you should use the Gtk.ListBox::selected-rows-changed signal instead.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.RowSelectedCallback.run(org.gnome.gtk.ListBoxRow)

onSelectAll

public B onSelectAll(ListBox.SelectAllCallback handler)

Emitted to select all children of the box, if the selection mode permits it.

This is a keybinding signal.

The default binding for this signal is Ctrl-a.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.SelectAllCallback.run()

onSelectedRowsChanged

public B onSelectedRowsChanged(ListBox.SelectedRowsChangedCallback handler)

Emitted when the set of selected rows changes.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.SelectedRowsChangedCallback.run()

onToggleCursorRow

public B onToggleCursorRow(ListBox.ToggleCursorRowCallback handler)

Emitted when the cursor row is toggled.

The default bindings for this signal is Ctrl+␣.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.ToggleCursorRowCallback.run()

onUnselectAll

public B onUnselectAll(ListBox.UnselectAllCallback handler)

Emitted to unselect all children of the box, if the selection mode permits it.

This is a keybinding signal.

The default binding for this signal is Ctrl-Shift-a.

Parameters:

handler - the signal handler

Returns:

the Builder instance is returned, to allow method chaining

See Also:

• ListBox.UnselectAllCallback.run()