:right-sidebar: True ActionRow =================================================================== .. currentmodule:: gi.repository.Adw .. class:: ActionRow(**properties: ~typing.Any) :no-contents-entry: Superclasses: :class:`~gi.repository.Adw.PreferencesRow`, :class:`~gi.repository.Gtk.ListBoxRow`, :class:`~gi.repository.Gtk.Widget`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object` Subclasses: :class:`~gi.repository.Adw.ComboRow`, :class:`~gi.repository.Adw.SpinRow`, :class:`~gi.repository.Adw.SwitchRow` Implemented Interfaces: :class:`~gi.repository.Gtk.Accessible`, :class:`~gi.repository.Gtk.Actionable`, :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.ConstraintTarget` :Constructors: :: ActionRow(**properties) new() -> Gtk.Widget Constructors ------------ .. rst-class:: interim-class .. class:: ActionRow :no-index: .. classmethod:: new() -> ~gi.repository.Gtk.Widget Creates a new ``AdwActionRow``. Methods ------- .. rst-class:: interim-class .. class:: ActionRow :no-index: .. method:: activate() -> None Activates ``self``. .. method:: add_prefix(widget: ~gi.repository.Gtk.Widget) -> None Adds a prefix widget to ``self``. :param widget: a widget .. method:: add_suffix(widget: ~gi.repository.Gtk.Widget) -> None Adds a suffix widget to ``self``. :param widget: a widget .. method:: get_activatable_widget() -> ~gi.repository.Gtk.Widget | None Gets the widget activated when ``self`` is activated. .. method:: get_icon_name() -> str | None Gets the icon name for ``self``. .. deprecated:: 1.3 Use :obj:`~gi.repository.ActionRow.add_prefix` to add an icon. .. method:: get_subtitle() -> str | None Gets the subtitle for ``self``. .. method:: get_subtitle_lines() -> int Gets the number of lines at the end of which the subtitle label will be ellipsized. .. method:: get_subtitle_selectable() -> bool Gets whether the user can copy the subtitle from the label .. versionadded:: 1.3 .. method:: get_title_lines() -> int Gets the number of lines at the end of which the title label will be ellipsized. .. method:: remove(widget: ~gi.repository.Gtk.Widget) -> None Removes a child from ``self``. :param widget: the child to be removed .. method:: set_activatable_widget(widget: ~gi.repository.Gtk.Widget | None = None) -> None Sets the widget to activate when ``self`` is activated. The row can be activated either by clicking on it, calling :obj:`~gi.repository.ActionRow.activate`, or via mnemonics in the title. See the :obj:`~gi.repository.Adw.PreferencesRow.props.use_underline` property to enable mnemonics. The target widget will be activated by emitting the :obj:`~gi.repository.Gtk.Widget.signals.mnemonic_activate` signal on it. :param widget: the target widget .. method:: set_icon_name(icon_name: str | None = None) -> None Sets the icon name for ``self``. .. deprecated:: 1.3 Use :obj:`~gi.repository.ActionRow.add_prefix` to add an icon. :param icon_name: the icon name .. method:: set_subtitle(subtitle: str) -> None Sets the subtitle for ``self``. The subtitle is interpreted as Pango markup unless :obj:`~gi.repository.Adw.PreferencesRow.props.use_markup` is set to ``FALSE``. :param subtitle: the subtitle .. method:: set_subtitle_lines(subtitle_lines: int) -> None 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. :param subtitle_lines: the number of lines at the end of which the subtitle label will be ellipsized .. method:: set_subtitle_selectable(subtitle_selectable: bool) -> None Sets whether the user can copy the subtitle from the label See also :obj:`~gi.repository.Gtk.Label.props.selectable`. .. versionadded:: 1.3 :param subtitle_selectable: ``TRUE`` if the user can copy the subtitle from the label .. method:: set_title_lines(title_lines: int) -> None 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. :param title_lines: the number of lines at the end of which the title label will be ellipsized Properties ---------- .. rst-class:: interim-class .. class:: ActionRow :no-index: .. attribute:: props.activatable_widget :type: ~gi.repository.Gtk.Widget The widget to activate when the row is activated. The row can be activated either by clicking on it, calling :obj:`~gi.repository.ActionRow.activate`, or via mnemonics in the title. See the :obj:`~gi.repository.Adw.PreferencesRow.props.use_underline` property to enable mnemonics. The target widget will be activated by emitting the :obj:`~gi.repository.Gtk.Widget.signals.mnemonic_activate` signal on it. .. attribute:: props.icon_name :type: str The icon name for this row. .. deprecated:: 1.3 Use :obj:`~gi.repository.ActionRow.add_prefix` to add an icon. .. attribute:: props.subtitle :type: str The subtitle for this row. The subtitle is interpreted as Pango markup unless :obj:`~gi.repository.Adw.PreferencesRow.props.use_markup` is set to ``FALSE``. .. attribute:: props.subtitle_lines :type: int 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. .. attribute:: props.subtitle_selectable :type: bool Whether the user can copy the subtitle from the label. See also :obj:`~gi.repository.Gtk.Label.props.selectable`. .. versionadded:: 1.3 .. attribute:: props.title_lines :type: int 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. Signals ------- .. rst-class:: interim-class .. class:: ActionRow.signals :no-index: .. method:: activated() -> None This signal is emitted after the row has been activated. Virtual Methods --------------- .. rst-class:: interim-class .. class:: ActionRow :no-index: .. method:: do_activate() -> None Activates ``self``. Fields ------ .. rst-class:: interim-class .. class:: ActionRow :no-index: .. attribute:: parent_instance