Adap.TabView – libadapta-1 – Vala Binding Reference

Description:

[ CCode ( type_id = "adap_tab_view_get_type ()" ) ]
public sealed class TabView : Widget, Accessible, Buildable, ConstraintTarget

A dynamic tabbed container.

`AdapTabView` 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 switcher and relies on external widgets for that, such as [class@TabBar], [class@TabOverview] and [ class@TabButton].

`AdapTabView` maintains a [class@TabPage] object for each page, which holds additional per-page properties. You can obtain the `AdapTabPage` for a page with [method@TabView.get_page], and as the return value for [method@TabView.append] and other functions for adding children.

`AdapTabView` 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 [class@Gtk.Notebook] for use cases such as tabbed dialogs.

As such, it does not support disabling page reordering or detaching.

`AdapTabView` adds a number of global page switching and reordering shortcuts. The [property@TabView:shortcuts] property can be used to manage them.

See [flags@TabViewShortcuts] for the list of the available shortcuts. All of the shortcuts are enabled by default.

[method@TabView.add_shortcuts] and [method@TabView.remove_shortcuts] can be used to manage shortcuts in a convenient way, for example:

```c adap_tab_view_remove_shortcuts (view, ADAP_TAB_VIEW_SHORTCUT_CONTROL_HOME | ADAP_TAB_VIEW_SHORTCUT_CONTROL_END); ```

CSS nodes

`AdapTabView` has a main CSS node with the name `tabview`.

Accessibility

`AdapTabView` uses the `GTK_ACCESSIBLE_ROLE_TAB_PANEL` for the tab pages which are the accessible parent objects of the child widgets.

Namespace: Adap

Content:

Properties:

public Icon default_icon { get; set; }

Default page icon.

public bool is_transferring_page { get; }

Whether a page is being transferred.

public MenuModel menu_model { get; set; }

Tab context menu model.

public int n_pages { get; }

The number of pages in the tab view.

public int n_pinned_pages { get; }

The number of pinned pages in the tab view.

public SelectionModel pages { owned get; }

A selection model with the tab view's pages.

public TabPage selected_page { get; set; }

The currently selected page.

public TabViewShortcuts shortcuts { get; set; }

The enabled shortcuts.

Creation methods:

public TabView ()

Creates a new `AdapTabView`.

Methods:

public unowned TabPage add_page (Widget child, TabPage? parent)

Adds child to this with parent as the parent.

public void add_shortcuts (TabViewShortcuts shortcuts)

Adds shortcuts for this .

public unowned TabPage append (Widget child)

Inserts child as the last non-pinned page.

public unowned TabPage append_pinned (Widget child)

Inserts child as the last pinned page.

public void close_other_pages (TabPage page)

Requests to close all pages other than page.

public void close_page_finish (TabPage page, bool confirm)

Completes a [method@TabView.

public void close_pages_after (TabPage page)

Requests to close all pages after page.

public void close_pages_before (TabPage page)

Requests to close all pages before page.

public unowned Icon get_default_icon ()

Gets the default icon of this.

public bool get_is_transferring_page ()

Whether a page is being transferred.

public unowned MenuModel? get_menu_model ()

Gets the tab context menu model for this .

public int get_n_pages ()

Gets the number of pages in this.

public int get_n_pinned_pages ()

Gets the number of pinned pages in this .

public unowned TabPage get_nth_page (int position)

Gets the [class@TabPage] representing the child at

position

public unowned TabPage get_page (Widget child)

Gets the [class@TabPage] object representing child.

public int get_page_position (TabPage page)

Finds the position of page in this, starting from 0.

public SelectionModel get_pages ()

Returns a [iface@Gio.

public unowned TabPage? get_selected_page ()

Gets the currently selected page in this .

public TabViewShortcuts get_shortcuts ()

Gets the enabled shortcuts for this.

public unowned TabPage insert (Widget child, int position)

Inserts a non-pinned page at position.

public unowned TabPage insert_pinned (Widget child, int position)

Inserts a pinned page at position.

public void invalidate_thumbnails ()

Invalidates thumbnails for all pages in this.

public unowned TabPage prepend (Widget child)

Inserts child as the first non-pinned page.

public unowned TabPage prepend_pinned (Widget child)

Inserts child as the first pinned page.

public void remove_shortcuts (TabViewShortcuts shortcuts)

Removes shortcuts from this .

public bool reorder_backward (TabPage page)

Reorders page to before its previous page if possible.

public bool reorder_first (TabPage page)

Reorders page to the first possible position.

public bool reorder_forward (TabPage page)

Reorders page to after its next page if possible.

public bool reorder_last (TabPage page)

Reorders page to the last possible position.

public bool reorder_page (TabPage page, int position)

Reorders page to position.

public bool select_next_page ()

Selects the page after the currently selected page.

public bool select_previous_page ()

Selects the page before the currently selected page.

public void set_default_icon (Icon default_icon)

Sets the default page icon for this.

public void set_menu_model (MenuModel? menu_model)

Sets the tab context menu model for this .

public void set_page_pinned (TabPage page, bool pinned)

Pins or unpins page.

public void set_selected_page (TabPage selected_page)

Sets the currently selected page in this .

public void set_shortcuts (TabViewShortcuts shortcuts)

Sets the enabled shortcuts for this.

public void transfer_page (TabPage page, TabView other_view, int position)

Transfers page from this to other_view.

Signals:

public signal bool close_page (TabPage page)

Emitted after [method@TabView.

public signal unowned TabView? create_window ()

Emitted when a tab should be transferred into a new window.

public signal void indicator_activated (TabPage page)

Emitted after the indicator icon on page has been activated.

public signal void page_attached (TabPage page, int position)

Emitted when a page has been created or transferred to

self

public signal void page_detached (TabPage page, int position)

Emitted when a page has been removed or transferred to another view.

public signal void page_reordered (TabPage page, int position)

Emitted after page has been reordered to

position

public signal void setup_menu (TabPage? page)

Emitted when a context menu is opened or closed for page.

Inherited Members:

TabView

Object Hierarchy: