SpinRow

class SpinRow(pointer: <Error class: unknown class><<Error class: unknown class>>) : ActionRow

An class@ActionRow with an embedded spin button.

spin-row

Example of an AdwSpinRow UI definition:

<object class="AdwSpinRow">
<property name="title" translatable="yes">Spin Row</property>
<property name="adjustment">
<object class="GtkAdjustment">
<property name="lower">0</property>
<property name="upper">100</property>
<property name="value">50</property>
<property name="page-increment">10</property>
<property name="step-increment">1</property>
</object>
</property>
</object>

See class@Gtk.SpinButton for details.

CSS nodes

AdwSpinRow has the same structure as class@ActionRow, as well as the .spin style class on the main node.

Accessibility

AdwSpinRow uses an internal GtkSpinButton with the GTK_ACCESSIBLE_ROLE_SPIN_BUTTON role.

Skipped during bindings generation

  • method adjustment: Property TypeInfo of getter and setter do not match

  • signal input: Unsupported parameter new_value : new_value: Out parameter is not supported

Since

1.4

Constructors

Link copied to clipboard
constructor(adjustment: <Error class: unknown class>? = null, climbRate: <Error class: unknown class>, digits: <Error class: unknown class>)

Creates a new AdwSpinRow.

constructor(min: <Error class: unknown class>, max: <Error class: unknown class>, step: <Error class: unknown class>)

Creates a new AdwSpinRow with the given properties.

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Link copied to clipboard
object Companion

Properties

Link copied to clipboard
open var activatableWidget: <Error class: unknown class>?

The widget to activate when the row is activated.

Link copied to clipboard
val adwActionRowPointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
val adwPreferencesRowPointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
val adwSpinRowPointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
var climbRate: <Error class: unknown class>

The acceleration rate when you hold down a button or key.

Link copied to clipboard
var digits: <Error class: unknown class>

The number of decimal places to display.

Link copied to clipboard
open override val gtkAccessiblePointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open override val gtkActionablePointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open override val gtkBuildablePointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open override val gtkConstraintTargetPointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open val gtkEditablePointer: <Error class: unknown class><<Error class: unknown class>>
Link copied to clipboard
open var iconName: String?

The icon name for this row.

Link copied to clipboard

Whether non-numeric characters should be ignored.

Link copied to clipboard

Whether invalid values are snapped to the nearest step increment.

Link copied to clipboard
open var subtitleLines: <Error class: unknown class>

The number of lines at the end of which the subtitle label will be ellipsized.

Link copied to clipboard

Whether the user can copy the subtitle from the label.

Link copied to clipboard
open var title: String

The title of the preference represented by this row.

Link copied to clipboard
open var titleLines: <Error class: unknown class>

The number of lines at the end of which the title label will be ellipsized.

Link copied to clipboard

Whether the user can copy the title from the label.

Link copied to clipboard
var updatePolicy: <Error class: unknown class>

The policy for updating the spin row.

Link copied to clipboard
open var useMarkup: Boolean

Whether to use Pango markup for the title label.

Link copied to clipboard

Whether an embedded underline in the title indicates a mnemonic.

Link copied to clipboard
var value: <Error class: unknown class>

The current value.

Link copied to clipboard

Whether the spin row should wrap upon reaching its limits.

Functions

Link copied to clipboard
open fun activate()

Activates @self.

Link copied to clipboard
open fun addPrefix(widget: <Error class: unknown class>)

Adds a prefix widget to @self.

Link copied to clipboard
open fun addSuffix(widget: <Error class: unknown class>)

Adds a suffix widget to @self.

Link copied to clipboard
fun configure(adjustment: <Error class: unknown class>? = null, climbRate: <Error class: unknown class>, digits: <Error class: unknown class>)

Changes the properties of an existing spin row.

Link copied to clipboard
fun connectActivated(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: () -> Unit): <Error class: unknown class>

This signal is emitted after the row has been activated.

Link copied to clipboard
fun connectOutput(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: () -> Boolean): <Error class: unknown class>

Emitted to tweak the formatting of the value for display.

Link copied to clipboard
fun connectWrapped(connectFlags: <Error class: unknown class> = ConnectFlags(0u), handler: () -> Unit): <Error class: unknown class>

Emitted right after the spinbutton wraps.

Link copied to clipboard
fun getAdjustment(): <Error class: unknown class>

Gets the adjustment that holds the value for the spin row.

Link copied to clipboard
open fun getSubtitle(): String?

Gets the subtitle for @self.

Link copied to clipboard
open fun remove(widget: <Error class: unknown class>)

Removes a child from @self.

Link copied to clipboard
fun setAdjustment(adjustment: <Error class: unknown class>? = null)

Sets the adjustment that holds the value for the spin row.

Link copied to clipboard
fun setRange(min: <Error class: unknown class>, max: <Error class: unknown class>)

Sets the minimum and maximum allowable values for @self.

Link copied to clipboard
open fun setSubtitle(subtitle: String)

Sets the subtitle for @self.

Link copied to clipboard
fun update()

Manually force an update of the spin row.