Class
GtkAssistant
deprecated: 4.10
Description [src]
final class Gtk.Assistant : Gtk.Window
implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
/* No available fields */
}GtkAssistant is used to represent a complex as a series of steps.
Each step consists of one or more pages. GtkAssistant guides the user
through the pages, and controls the page flow to collect the data needed
for the operation.
GtkAssistant handles which buttons to show and to make sensitive based
on page sequence knowledge and the GtkAssistantPageType of each
page in addition to state information like the completed and committed
page statuses.
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 maintains a GtkAssistantPage object for each added
child, which holds additional per-child properties. You
obtain the GtkAssistantPage for a child with gtk_assistant_get_page().
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. If you need to set per-object
properties, create a GtkAssistantPage object explicitly, and
set the child widget as a property on it.
CSS nodes
GtkAssistant has a single CSS node with the name window and style
class .assistant.
Deprecated since: 4.10
This widget will be removed in GTK 5.
Instance methods
gtk_assistant_add_action_widget
Adds a widget to the action area of a GtkAssistant.
deprecated: 4.10
gtk_assistant_get_nth_page
Returns the child widget contained in page number page_num.
deprecated: 4.10
gtk_assistant_remove_action_widget
Removes a widget from the action area of a GtkAssistant.
deprecated: 4.10
gtk_assistant_set_forward_page_func
Sets the page forwarding function to be page_func.
deprecated: 4.10
gtk_assistant_update_buttons_state
Forces assistant to recompute the buttons state.
deprecated: 4.10
Methods inherited from GtkAccessible (20)
Methods inherited from GtkBuildable (1)
Properties
Gtk.Assistant:use-header-bar
TRUE if the assistant uses a GtkHeaderBar for action buttons
instead of the action-area.
deprecated: 4.10
Properties inherited from GtkAccessible (1)
Signals
Gtk.Assistant::close
Emitted either when the close button of a summary page is clicked,
or when the apply button in the last page in the flow (of type
GTK_ASSISTANT_PAGE_CONFIRM) is clicked.
deprecated: 4.10
Gtk.Assistant::prepare
Emitted when a new page is set as the assistant’s current page, before making the new page visible.
deprecated: 4.10