NavigationPage

Object Hierarchy:

Description:

[ CCode ( type_id = "adw_navigation_page_get_type ()" ) ]
[ Version ( since = "1.4" ) ]
public class NavigationPage : Widget, Accessible, Buildable, ConstraintTarget

A page within [class@NavigationView] or [class@NavigationSplitView].

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

The [signal@NavigationPage:AdwNavigationPage:showing], [signal@NavigationPage:AdwNavigationPage:shown], [ signal@NavigationPage:AdwNavigationPage:hiding] and [signal@NavigationPage:AdwNavigationPage:hidden] signals can be used to track the page's visibility within its `AdwNavigationView`.

Header Bar Integration

When placed inside `AdwNavigationPage`, [class@HeaderBar] will display the page title instead of window title.

When used together with [class@NavigationView], it will also display a back button that can be used to go back to the previous page. Set [ property@HeaderBar: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.

Namespace: Adw

Package: libadwaita-1

Content:

Properties:

public bool can_pop { get; set; }
Whether the page can be popped from navigation stack.
public Widget child { get; set; }
The child widget.
public string tag { get; set; }
The page tag.
public string title { get; set; }
The page title.

Creation methods:

public NavigationPage (Widget child, string title)
Creates a new `AdwNavigationPage`.
public NavigationPage.with_tag (Widget child, string title, string tag)
Creates a new `AdwNavigationPage` with provided tag.

Methods:

public bool get_can_pop ()
Gets whether this can be popped from navigation stack.
public unowned Widget? get_child ()
Gets the child widget of this.
public unowned string? get_tag ()
Gets the tag of this.
public unowned string get_title ()
Gets the title of this.
public void set_can_pop (bool can_pop)
Sets whether this can be popped from navigation stack.
public void set_child (Widget? child)
Sets the child widget of this.
public void set_tag (string? tag)
Sets the tag for this.
public void set_title (string title)
Sets the title of this.

Signals:

public virtual signal void hidden ()
Emitted when the navigation view transition has been completed and the page is fully hidden.
public virtual signal void hiding ()
Emitted when the page starts hiding at the beginning of the navigation view transition.
public virtual signal void showing ()
Emitted when the page shows at the beginning of the navigation view transition.
public virtual signal void shown ()
Emitted when the navigation view transition has been completed and the page is fully shown.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable