gtk.assistant

Module for [Assistant] class

class Assistant AssistantGidBuilder AssistantGidBuilderImpl

Types 3

A #GtkAssistant is a widget used to represent a generally complex operation splitted in several steps, guiding the user through its pages and controlling the page flow to collect the necessary data.

The design of GtkAssistant is that it controls what buttons to show and to make sensitive, based on what it knows about the page sequence and the [type][GtkAssistantPageType] of each page, in addition to state information like the page [completion][gtk-assistant-set-page-complete] and [committed][gtk-assistant-commit] status.

If you have a case that doesn’t quite fit in #GtkAssistants way of handling buttons, you can use the #GTK_ASSISTANT_PAGE_CUSTOM page type and handle buttons yourself.

GtkAssistant as GtkBuildable

The GtkAssistant implementation of the #GtkBuildable interface exposes the @action_area as internal children with the name “action_area”.

To add pages to an assistant in #GtkBuilder, simply add it as a child to the GtkAssistant object, and set its child properties as necessary.

CSS nodes

GtkAssistant has a single CSS node with the name assistant.

Methods

GType _getGType()

GType _gType() @property

Assistant self()Returns `this`, for use in `with` statements.

AssistantGidBuilder builder()Get builder for [gtk.assistant.Assistant] Returns: New builder object

int useHeaderBar() @propertyGet `useHeaderBar` property. Returns: true if the assistant uses a #GtkHeaderBar for action buttons instead of the action-area.

void addActionWidget(gtk.widget.Widget child)Adds a widget to the action area of a #GtkAssistant.

int appendPage(gtk.widget.Widget page)Appends a page to the assistant.

void commit()Erases the visited page history so the back button is not shown on the current page, and removes the cancel button from subsequent pages.

int getCurrentPage()Returns the page number of the current page. Returns: The index (starting from 0) of the current page in the assistant, or -1 if the assistant has no pages, or no current page.

int getNPages()Returns the number of pages in the assistant Returns: the number of pages in the assistant

gtk.widget.Widget getNthPage(int pageNum)Returns the child widget contained in page number page_num.

bool getPageComplete(gtk.widget.Widget page)Gets whether page is complete.

bool getPageHasPadding(gtk.widget.Widget page)Gets whether page has padding.

gdkpixbuf.pixbuf.Pixbuf getPageHeaderImage(gtk.widget.Widget page)Gets the header image for page.

gdkpixbuf.pixbuf.Pixbuf getPageSideImage(gtk.widget.Widget page)Gets the side image for page.

string getPageTitle(gtk.widget.Widget page)Gets the title for page.

gtk.types.AssistantPageType getPageType(gtk.widget.Widget page)Gets the page type of page.

int insertPage(gtk.widget.Widget page, int position)Inserts a page in the assistant at a given position.

void nextPage()Navigate to the next page.

int prependPage(gtk.widget.Widget page)Prepends a page to the assistant.

void previousPage()Navigate to the previous visited page.

void removeActionWidget(gtk.widget.Widget child)Removes a widget from the action area of a #GtkAssistant.

void removePage(int pageNum)Removes the page_num’s page from assistant.

void setCurrentPage(int pageNum)Switches the page to page_num.

void setForwardPageFunc(gtk.types.AssistantPageFunc pageFunc = null)Sets the page forwarding function to be page_func.

void setPageComplete(gtk.widget.Widget page, bool complete)Sets whether page contents are complete.

void setPageHasPadding(gtk.widget.Widget page, bool hasPadding)Sets whether the assistant is adding padding around the page.

void setPageHeaderImage(gtk.widget.Widget page, gdkpixbuf.pixbuf.Pixbuf pixbuf = null)Sets a header image for page.

void setPageSideImage(gtk.widget.Widget page, gdkpixbuf.pixbuf.Pixbuf pixbuf = null)Sets a side image for page.

void setPageTitle(gtk.widget.Widget page, string title)Sets a title for page.

void setPageType(gtk.widget.Widget page, gtk.types.AssistantPageType type)Sets the page type for page.

void updateButtonsState()Forces assistant to recompute the buttons state.

gulong connectApply(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] :  gtk.assistant.Assistant)))
   &&  Parameters!T.length <  2)

Connect to `Apply` signal.

gulong connectCancel(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] :  gtk.assistant.Assistant)))
   &&  Parameters!T.length <  2)

Connect to `Cancel` signal.

gulong connectClose(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] :  gtk.assistant.Assistant)))
   &&  Parameters!T.length <  2)

Connect to `Close` signal.

gulong connectEscape(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] :  gtk.assistant.Assistant)))
   &&  Parameters!T.length <  2)

Connect to `Escape` signal.

gulong connectPrepare(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] :  gtk.widget.Widget)))
   && (Parameters!T.length <  2 || (ParameterStorageClassTuple!T[1]  ==  ParameterStorageClass.none &&  is(Parameters!T[1] :  gtk.assistant.Assistant)))
   &&  Parameters!T.length <  3)

Connect to `Prepare` signal.

Constructors

this(void * ptr, Flag!"Take" take)

this()Creates a new #GtkAssistant. Returns: a newly created #GtkAssistant

classAssistantGidBuilderImpl(T) : gtk.window.WindowGidBuilderImpl!T

Methods

T useHeaderBar(int propval)Set `useHeaderBar` property. Params: propval = true if the assistant uses a #GtkHeaderBar for action buttons instead of the action-area.

classAssistantGidBuilder : AssistantGidBuilderImpl!AssistantGidBuilder

Fluent builder for [gtk.assistant.Assistant]

Methods

Assistant build()