adw.navigation_page

Module for [NavigationPage] class

Types 3

A page within class@NavigationView or class@NavigationSplitView.

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

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

Header Bar Integration

When placed inside [adw.navigation_page.NavigationPage], 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

[adw.navigation_page.NavigationPage] has a single CSS node with name navigation-view-page.

Accessibility

[adw.navigation_page.NavigationPage] uses the [gtk.types.AccessibleRole.Group] role.

Methods
GType _gType() @property
NavigationPage self()Returns `this`, for use in `with` statements.
NavigationPageGidBuilder builder()Get builder for [adw.navigation_page.NavigationPage] Returns: New builder object
bool canPop() @propertyGet `canPop` property. Returns: Whether the page can be popped from navigation stack.
void canPop(bool propval) @propertySet `canPop` property. Params: propval = Whether the page can be popped from navigation stack.
gtk.widget.Widget child() @propertyGet `child` property. Returns: The child widget.
void child(gtk.widget.Widget propval) @propertySet `child` property. Params: propval = The child widget.
string tag() @propertyGet `tag` property. Returns: The page tag.
void tag(string propval) @propertySet `tag` property. Params: propval = The page tag.
string title() @propertyGet `title` property. Returns: The page title.
void title(string propval) @propertySet `title` property. Params: propval = The page title.
adw.navigation_page.NavigationPage newWithTag(gtk.widget.Widget child, string title, string tag)Creates a new [adw.navigation_page.NavigationPage] with provided tag.
bool getCanPop()Gets whether self can be popped from navigation stack. Returns: whether the page can be popped from navigation stack
gtk.widget.Widget getChild()Gets the child widget of self. Returns: the child widget of self
string getTag()Gets the tag of self. Returns: the page tag
string getTitle()Gets the title of self. Returns: the title of self
void setCanPop(bool canPop)Sets whether self can be popped from navigation stack.
void setChild(gtk.widget.Widget child = null)Sets the child widget of self.
void setTag(string tag = null)Sets the tag for self.
void setTitle(string title)Sets the title of self.
gulong connectHidden(T)(T callback, Flag!"After" after = No.After) if (isCallable!T && is(ReturnType!T == void) && (Parameters!T.length < 1 || (ParameterStorageClassTuple!T[0] == ParameterStorageClass.none && is(Parameters!T[0] : adw.navigation_page.NavigationPage))) && Parameters!T.length < 2)Connect to `Hidden` signal.
gulong connectHiding(T)(T callback, Flag!"After" after = No.After) if (isCallable!T && is(ReturnType!T == void) && (Parameters!T.length < 1 || (ParameterStorageClassTuple!T[0] == ParameterStorageClass.none && is(Parameters!T[0] : adw.navigation_page.NavigationPage))) && Parameters!T.length < 2)Connect to `Hiding` signal.
gulong connectShowing(T)(T callback, Flag!"After" after = No.After) if (isCallable!T && is(ReturnType!T == void) && (Parameters!T.length < 1 || (ParameterStorageClassTuple!T[0] == ParameterStorageClass.none && is(Parameters!T[0] : adw.navigation_page.NavigationPage))) && Parameters!T.length < 2)Connect to `Showing` signal.
gulong connectShown(T)(T callback, Flag!"After" after = No.After) if (isCallable!T && is(ReturnType!T == void) && (Parameters!T.length < 1 || (ParameterStorageClassTuple!T[0] == ParameterStorageClass.none && is(Parameters!T[0] : adw.navigation_page.NavigationPage))) && Parameters!T.length < 2)Connect to `Shown` signal.
Constructors
this(void * ptr, Flag!"Take" take)
this(gtk.widget.Widget child, string title)Creates a new [adw.navigation_page.NavigationPage].
Methods
T canPop(bool propval)Set `canPop` property. Params: propval = Whether the page can be popped from navigation stack.
T child(gtk.widget.Widget propval)Set `child` property. Params: propval = The child widget. Returns: Builder instance for fluent chaining
T tag(string propval)Set `tag` property. Params: propval = The page tag.
T title(string propval)Set `title` property. Params: propval = The page title.

Fluent builder for [adw.navigation_page.NavigationPage]