Handy.TabView
Description: Reference for Handy.TabView

### 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.