Class
AdwSidebarItem
unstable since: 1.9
Description [src]
class Adw.SidebarItem : GObject.Object
{
/* No available fields */
}
An item within AdwSidebarSection.
Sidebar items must have a title, set via AdwSidebarItem:title.
Sidebar items should, but are not required to, have an icon. Icons can be set
from an icon name, via AdwSidebarItem:icon-name, or a
GdkPaintable, via AdwSidebarItem:icon-paintable.
Items can also have subtitles, set with the AdwSidebarItem:subtitle
property. Subtitles should be used sparingly.
To add a tooltip, use AdwSidebarItem:tooltip. Tooltips always use
Pango markup.
Items can have an arbitrary suffix widget, set with the
AdwSidebarItem:suffix properties. It will be displayed at the end of
its row, or before the arrow in the ADW_SIDEBAR_MODE_PAGE mode.
To hide or disable the item, use the AdwSidebarItem:visible and
AdwSidebarItem:enabled properties respectively.
To access the items’s section, use AdwSidebarItem:section.
It’s also possible to access the index of the item in both the section and
the sidebar, using adw_sidebar_item_get_section_index() and
adw_sidebar_item_get_index() respectively.
Dragging content over sidebar items activates them by default. To disable
this behavior, set AdwSidebarItem:drag-motion-activate to FALSE.
AdwSidebarItem is derivable, and applications that need to associate each
page with data can store it in the items themselves this way.
Available since: 1.9
Instance methods
adw_sidebar_item_get_drag_motion_activate
Gets whether self will be activated on pointer motion during Drag-and-Drop.
unstable since: 1.9
adw_sidebar_item_get_icon_paintable
Gets the paintable used as the icon for item.
unstable since: 1.9
adw_sidebar_item_get_section_index
Gets index of self within its AdwSidebarSection.
unstable since: 1.9
adw_sidebar_item_get_use_underline
Gets whether an underline in the title indicates a mnemonic.
unstable since: 1.9
adw_sidebar_item_set_drag_motion_activate
Sets whether to activate self on pointer motion during Drag-and-Drop.
unstable since: 1.9
adw_sidebar_item_set_icon_paintable
Sets the paintable to use as the icon for item.
unstable since: 1.9
adw_sidebar_item_set_use_underline
Sets whether an underline in the title indicates a mnemonic.
unstable since: 1.9
Properties
Adw.SidebarItem:drag-motion-activate
Whether to activate the item on pointer motion during Drag-and-Drop.
unstable since: 1.9
Adw.SidebarItem:use-underline
Whether an underline in the title indicates a mnemonic.
unstable since: 1.9
Signals
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.