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

Ancestors

  • GtkBin
  • GtkContainer
  • GtkWidget
  • GInitiallyUnowned
  • GObject

Implements

  • AtkImplementorIface
  • GtkBuildable

Constructors

hdy_tab_view_new

Creates a new HdyTabView.

Available since: 1.2

Instance methods

hdy_tab_view_add_page

Adds child to self with parent as the parent.

Available since: 1.2

hdy_tab_view_append

Inserts child as the last non-pinned page.

Available since: 1.2

hdy_tab_view_append_pinned

Inserts child as the last pinned page.

Available since: 1.2

hdy_tab_view_close_other_pages

Requests to close all pages other than page.

Available since: 1.2

hdy_tab_view_close_page

Requests to close page.

Available since: 1.2

hdy_tab_view_close_page_finish

Completes a hdy_tab_view_close_page() call for page.

Available since: 1.2

hdy_tab_view_close_pages_after

Requests to close all pages after page.

Available since: 1.2

hdy_tab_view_close_pages_before

Requests to close all pages before page.

Available since: 1.2

hdy_tab_view_get_default_icon

Gets default icon of self.

Available since: 1.2

hdy_tab_view_get_is_transferring_page

Whether a page is being transferred.

Available since: 1.2

hdy_tab_view_get_menu_model

Gets the tab context menu model for self.

Available since: 1.2

hdy_tab_view_get_n_pages

Gets the number of pages in self.

Available since: 1.2

hdy_tab_view_get_n_pinned_pages

Gets the number of pinned pages in self.

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

Gets the HdyTabPage object representing child.

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_get_pages

Returns a GListModel containing the pages of self.

Available since: 1.2

hdy_tab_view_get_selected_page

Gets the currently selected page in self.

Available since: 1.2

hdy_tab_view_get_shortcut_widget

Gets the shortcut widget for self.

Available since: 1.2

hdy_tab_view_insert

Inserts a non-pinned page at position.

Available since: 1.2

hdy_tab_view_insert_pinned

Inserts a pinned page at position.

Available since: 1.2

hdy_tab_view_prepend

Inserts child as the first non-pinned page.

Available since: 1.2

hdy_tab_view_prepend_pinned

Inserts child as the first pinned page.

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_reorder_first

Reorders page to the first possible position.

Available since: 1.2

hdy_tab_view_reorder_forward

Reorders page to after its next page if possible.

Available since: 1.2

hdy_tab_view_reorder_last

Reorders page to the last possible position.

Available since: 1.2

hdy_tab_view_reorder_page

Reorders page to position.

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

hdy_tab_view_set_default_icon

Sets default page icon for self.

Available since: 1.2

hdy_tab_view_set_menu_model

Sets the tab context menu model for self.

Available since: 1.2

hdy_tab_view_set_page_pinned

Pins or unpins page.

Available since: 1.2

hdy_tab_view_set_selected_page

Sets the currently selected page in self.

Available since: 1.2

hdy_tab_view_set_shortcut_widget

Sets the shortcut widget for self.

Available since: 1.2

hdy_tab_view_transfer_page

Transfers page from self to other_view.

Available since: 1.2

Properties

Handy.TabView:default-icon

Default page icon.

Available since: 1.2

Handy.TabView:is-transferring-page

Whether a page is being transferred.

Available since: 1.2

Handy.TabView:menu-model

Tab context menu model.

Available since: 1.2

Handy.TabView:n-pages

The number of pages in the tab view.

Available since: 1.2

Handy.TabView:n-pinned-pages

The number of pinned pages in the tab view.

Available since: 1.2

Handy.TabView:selected-page

The currently selected page.

Available since: 1.2

Handy.TabView:shortcut-widget

Tab shortcut widget.

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

Class structure

struct HandyTabViewClass {
  GtkBinClass parent_class;
  
}
Class members
parent_class
GtkBinClass
  No description available.