set_page_pinned
Description:
Pins or unpins page
.
Pinned pages are guaranteed to be placed before all non-pinned pages; at any given moment the first [property@TabView:n-pinned-pages] pages in this are guaranteed to be pinned.
When a page is pinned or unpinned, it's automatically reordered: pinning a page moves it after other pinned pages; unpinning a page moves it before other non-pinned pages.
Pinned pages can still be reordered between each other.
[class@TabBar] will display pinned pages in a compact form, never showing the title or close button, and only showing a single icon, selected in the following order:
- [property@TabPage:indicator-icon]
- A spinner if [property@TabPage:loading] is `TRUE`
- [property@TabPage:icon]
- [property@TabView:default-icon]
[class@TabOverview] will not show a thumbnail for pinned pages, and replace the close button with an unpin button. Unlike `AdwTabBar`, it will still display the page's title, icon and indicator separately.
Pinned pages cannot be closed by default, see [signal@TabView:AdwTabView:close-page
] for how to override that behavior.
Changes the value of the [property@TabPage:pinned] property.
Parameters:
this |
a tab view |
page |
a page of this |
pinned |
whether |