adwaita/org.gtkkn.bindings.adw/SwitchRow

SwitchRow

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

A class@Gtk.ListBoxRow used to represent two states.

switch-row

The AdwSwitchRow widget contains a class@Gtk.Switch that allows the user to select between two states: "on" or "off". When activated, the row will invert its active state.

The user can control the switch by activating the row or by dragging on the switch handle.

See class@Gtk.Switch for details.

Example of an AdwSwitchRow UI definition:

<object class="AdwSwitchRow">
  <property name="title" translatable="yes">Switch Row</property>
  <signal name="notify::active" handler="switch_row_notify_active_cb"/>
</object>

The property@SwitchRow:active property should be connected to in order to monitor changes to the active state.

Accessibility

AdwSwitchRow uses the GTK_ACCESSIBLE_ROLE_SWITCH role.

Since

1.4

Constructors

constructor()

Creates a new AdwSwitchRow.

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

Types

object Companion

Properties

activatableWidget

open var activatableWidget: <Error class: unknown class>?

The widget to activate when the row is activated.

var active: Boolean

Whether the switch row is in the "on" or "off" position.

adwActionRowPointer

val adwActionRowPointer: <Error class: unknown class><<Error class: unknown class>>

adwPreferencesRowPointer

val adwPreferencesRowPointer: <Error class: unknown class><<Error class: unknown class>>

adwSwitchRowPointer

val adwSwitchRowPointer: <Error class: unknown class><<Error class: unknown class>>

gtkAccessiblePointer

open override val gtkAccessiblePointer: <Error class: unknown class><<Error class: unknown class>>

gtkActionablePointer

open override val gtkActionablePointer: <Error class: unknown class><<Error class: unknown class>>

gtkBuildablePointer

open override val gtkBuildablePointer: <Error class: unknown class><<Error class: unknown class>>

gtkConstraintTargetPointer

open override val gtkConstraintTargetPointer: <Error class: unknown class><<Error class: unknown class>>

open var iconName: String?

The icon name for this row.

open var subtitleLines: <Error class: unknown class>

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

subtitleSelectable

open var subtitleSelectable: Boolean

Whether the user can copy the subtitle from the label.

open var title: String

The title of the preference represented by this row.

open var titleLines: <Error class: unknown class>

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

titleSelectable

open var titleSelectable: Boolean

Whether the user can copy the title from the label.

open var useMarkup: Boolean

Whether to use Pango markup for the title label.

open var useUnderline: Boolean

Whether an embedded underline in the title indicates a mnemonic.

Functions

open fun activate()

Activates @self.

open fun addPrefix(widget: <Error class: unknown class>)

Adds a prefix widget to @self.

open fun addSuffix(widget: <Error class: unknown class>)

Adds a suffix widget to @self.

connectActivated

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.

open fun getSubtitle(): String?

Gets the subtitle for @self.

open fun remove(widget: <Error class: unknown class>)

Removes a child from @self.

open fun setSubtitle(subtitle: String)

Sets the subtitle for @self.