Class

AdwNavigationPage

Description [src]

class Adw.NavigationPage : Gtk.Widget {
  parent_instance: GtkWidget
}

A page within AdwNavigationView or AdwNavigationSplitView.

Each page has a child widget, a title and optionally a tag.

The AdwNavigationPage::showing, AdwNavigationPage::shown, AdwNavigationPage::hiding and AdwNavigationPage::hidden signals can be used to track the page’s visibility within its AdwNavigationView.

Header Bar Integration

When placed inside AdwNavigationPage, AdwHeaderBar will display the page title instead of window title.

When used together with AdwNavigationView, it will also display a back button that can be used to go back to the previous page. Set AdwHeaderBar:show-back-button to FALSE to disable that behavior if it’s unwanted.

CSS Nodes

AdwNavigationPage has a single CSS node with name navigation-view-page.

Accessibility

AdwNavigationPage uses the GTK_ACCESSIBLE_ROLE_GROUP role.

Available since:1.4

Ancestors

  • GtkWidget
  • GInitiallyUnowned
  • GObject

Implements

  • GtkAccessible
  • GtkBuildable
  • GtkConstraintTarget

Constructors

adw_navigation_page_new

Creates a new AdwNavigationPage.

Available since: 1.4

adw_navigation_page_new_with_tag

Creates a new AdwNavigationPage with provided tag.

Available since: 1.4

Instance methods

adw_navigation_page_get_can_pop

Gets whether self can be popped from navigation stack.

Available since: 1.4

adw_navigation_page_get_child

Gets the child widget of self.

Available since: 1.4

adw_navigation_page_get_tag

Gets the tag of self.

Available since: 1.4

adw_navigation_page_get_title

Gets the title of self.

Available since: 1.4

adw_navigation_page_set_can_pop

Sets whether self can be popped from navigation stack.

Available since: 1.4

adw_navigation_page_set_child

Sets the child widget of self.

Available since: 1.4

adw_navigation_page_set_tag

Sets the tag for self.

Available since: 1.4

adw_navigation_page_set_title

Sets the title of self.

Available since: 1.4

Properties

Adw.NavigationPage:can-pop

Whether the page can be popped from navigation stack.

Available since: 1.4

Adw.NavigationPage:child

The child widget.

Available since: 1.4

Adw.NavigationPage:tag

The page tag.

Available since: 1.4

Adw.NavigationPage:title

The page title.

Available since: 1.4

Signals

Adw.NavigationPage::hidden

Emitted when the navigation view transition has been completed and the page is fully hidden.

Available since: 1.4

Adw.NavigationPage::hiding

Emitted when the page starts hiding at the beginning of the navigation view transition.

Available since: 1.4

Adw.NavigationPage::showing

Emitted when the page shows at the beginning of the navigation view transition.

Available since: 1.4

Adw.NavigationPage::shown

Emitted when the navigation view transition has been completed and the page is fully shown.

Available since: 1.4

Class structure

struct AdwNavigationPageClass {
  GtkWidgetClass parent_class;
  void (* showing) (
    AdwNavigationPage* self
  );
  void (* shown) (
    AdwNavigationPage* self
  );
  void (* hiding) (
    AdwNavigationPage* self
  );
  void (* hidden) (
    AdwNavigationPage* self
  );
  
}
Class members
parent_class
GtkWidgetClass
  No description available.
showing
void (* showing) (
    AdwNavigationPage* self
  )
  No description available.
shown
void (* shown) (
    AdwNavigationPage* self
  )
  No description available.
hiding
void (* hiding) (
    AdwNavigationPage* self
  )
  No description available.
hidden
void (* hidden) (
    AdwNavigationPage* self
  )
  No description available.

Virtual methods

Adw.NavigationPageClass.hidden

Called when the navigation view transition has been completed and the page is fully hidden.

Available since: 1.4

Adw.NavigationPageClass.hiding

Called when the page starts hiding at the beginning of the navigation view transition.

Available since: 1.4

Adw.NavigationPageClass.showing

Called when the page shows at the beginning of the navigation view transition.

Available since: 1.4

Adw.NavigationPageClass.shown

Called when the navigation view transition has been completed and the page is fully shown.

Available since: 1.4