Class
HandyTabView
Description [src]
final class Handy.TabView : Gtk.Bin {
/* No available fields */
}
A dynamic tabbed container.
HdyTabView
is a container which shows one child at a time. While it
provides keyboard shortcuts for switching between pages, it does not provide
a visible tab bar and relies on external widgets for that, such as
HdyTabBar
.
HdyTabView
maintains a HdyTabPage
object for each page,which holds
additional per-page properties. You can obtain the HdyTabPage
for a page
with hdy_tab_view_get_page()
, and as return value for
hdy_tab_view_append()
and other functions for adding children.
HdyTabView
only aims to be useful for dynamic tabs in multi-window
document-based applications, such as web browsers, file managers, text
editors or terminals. It does not aim to replace GtkNotebook
for use
cases such as tabbed dialogs.
As such, it does not support disabling page reordering or detaching, or
adding children via GtkBuildable
.
CSS nodes
HdyTabView
has a main CSS node with the name tabview
.
It contains the subnode overlay, which contains subnodes stack and widget. The stack subnode contains the added pages.
tabview
╰── overlay
├── stack
│ ╰── [ Children ]
╰── widget
Available since: | 1.2 |
Instance methods
hdy_tab_view_close_page_finish
Completes a hdy_tab_view_close_page()
call for page
.
Available since: 1.2
hdy_tab_view_get_nth_page
Gets the HdyTabPage
representing the child at position
.
Available since: 1.2
hdy_tab_view_get_page_position
Finds the position of page
in self
, starting from 0.
Available since: 1.2
hdy_tab_view_reorder_backward
Reorders page
to before its previous page if possible.
Available since: 1.2
hdy_tab_view_select_next_page
Selects the page after the currently selected page.
Available since: 1.2
hdy_tab_view_select_previous_page
Selects the page before the currently selected page.
Available since: 1.2
Signals
Handy.TabView::close-page
Emitted after hdy_tab_view_close_page()
has been called for page
.
Available since: 1.2
Handy.TabView::create-window
Emitted when a tab should be transferred into a new window.
Available since: 1.2
Handy.TabView::indicator-activated
Emitted after the indicator icon on page
has been activated.
Available since: 1.2
Handy.TabView::page-attached
Emitted when a page has been created or transferred to the view.
Available since: 1.2
Handy.TabView::page-detached
Emitted when a page has been removed or transferred to another view.
Available since: 1.2
Handy.TabView::page-reordered
This signal is emitted after page
has been reordered to position
.
Available since: 1.2
Handy.TabView::setup-menu
Emitted when a context menu is opened or closed for page
.
Available since: 1.2