GI.Gtk.Objects.Assistant

A Assistant 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 Buildable interface exposes the actionArea as internal children with the name “action_area”.

To add pages to an assistant in Builder, 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.

Exported types

newtype Assistant

Memory-managed wrapper type.

Constructors

Assistant (ManagedPtr Assistant)

Instances

Eq Assistant

Defined in GI.Gtk.Objects.Assistant

Methods

(==) :: Assistant -> Assistant -> Bool

(/=) :: Assistant -> Assistant -> Bool

GObject Assistant

Defined in GI.Gtk.Objects.Assistant

ManagedPtrNewtype Assistant

Defined in GI.Gtk.Objects.Assistant

Methods

toManagedPtr :: Assistant -> ManagedPtr Assistant

TypedObject Assistant

Defined in GI.Gtk.Objects.Assistant

Methods

glibType :: IO GType

HasParentTypes Assistant

Defined in GI.Gtk.Objects.Assistant

IsGValue (Maybe Assistant)

Convert Assistant to and from GValue. See toGValue and fromGValue.

Defined in GI.Gtk.Objects.Assistant

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe Assistant -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe Assistant)

type ParentTypes Assistant

Defined in GI.Gtk.Objects.Assistant

type ParentTypes Assistant = '[Window, Bin, Container, Widget, Object, ImplementorIface, Buildable]

class (GObject o, IsDescendantOf Assistant o) => IsAssistant o

Type class for types which can be safely cast to Assistant, for instance with toAssistant.

Instances

(GObject o, IsDescendantOf Assistant o) => IsAssistant o

Defined in GI.Gtk.Objects.Assistant

toAssistant :: (MonadIO m, IsAssistant o) => o -> m Assistant

Cast to Assistant, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

activate, activateDefault, activateFocus, activateKey, add, addAccelGroup, addAccelerator, addActionWidget, addChild, addDeviceEvents, addEvents, addMnemonic, addMnemonicLabel, addTickCallback, appendPage, beginMoveDrag, beginResizeDrag, bindProperty, bindPropertyFull, canActivateAccel, checkResize, childFocus, childGetProperty, childNotify, childNotifyByPspec, childSetProperty, childType, classPath, close, commit, computeExpand, constructChild, createPangoContext, createPangoLayout, customFinished, customTagEnd, customTagStart, deiconify, destroy, destroyed, deviceIsShadowed, dragBegin, dragBeginWithCoordinates, dragCheckThreshold, dragDestAddImageTargets, dragDestAddTextTargets, dragDestAddUriTargets, dragDestFindTarget, dragDestGetTargetList, dragDestGetTrackMotion, dragDestSet, dragDestSetProxy, dragDestSetTargetList, dragDestSetTrackMotion, dragDestUnset, dragGetData, dragHighlight, dragSourceAddImageTargets, dragSourceAddTextTargets, dragSourceAddUriTargets, dragSourceGetTargetList, dragSourceSet, dragSourceSetIconGicon, dragSourceSetIconName, dragSourceSetIconPixbuf, dragSourceSetIconStock, dragSourceSetTargetList, dragSourceUnset, dragUnhighlight, draw, ensureStyle, errorBell, event, forall, forceFloating, foreach, freezeChildNotify, freezeNotify, fullscreen, fullscreenOnMonitor, getv, grabAdd, grabDefault, grabFocus, grabRemove, hasDefault, hasFocus, hasGrab, hasGroup, hasRcStyle, hasScreen, hasToplevelFocus, hasVisibleFocus, hide, hideOnDelete, iconify, inDestruction, initTemplate, inputShapeCombineRegion, insertActionGroup, insertPage, intersect, isActive, isAncestor, isComposited, isDrawable, isFloating, isFocus, isMaximized, isSensitive, isToplevel, isVisible, keynavFailed, listAccelClosures, listActionPrefixes, listMnemonicLabels, map, maximize, mnemonicActivate, modifyBase, modifyBg, modifyCursor, modifyFg, modifyFont, modifyStyle, modifyText, move, nextPage, notify, notifyByPspec, overrideBackgroundColor, overrideColor, overrideCursor, overrideFont, overrideSymbolicColor, parseGeometry, parserFinished, path, prependPage, present, presentWithTime, previousPage, propagateDraw, propagateKeyEvent, queueAllocate, queueComputeExpand, queueDraw, queueDrawArea, queueDrawRegion, queueResize, queueResizeNoRedraw, realize, ref, refSink, regionIntersect, registerWindow, remove, removeAccelGroup, removeAccelerator, removeActionWidget, removeMnemonic, removeMnemonicLabel, removePage, removeTickCallback, renderIcon, renderIconPixbuf, reparent, resetRcStyles, resetStyle, reshowWithInitialSize, resize, resizeChildren, resizeGripIsVisible, resizeToGeometry, runDispose, sendExpose, sendFocusChange, shapeCombineRegion, show, showAll, showNow, sizeAllocate, sizeAllocateWithBaseline, sizeRequest, stealData, stealQdata, stick, styleAttach, styleGetProperty, thawChildNotify, thawNotify, translateCoordinates, triggerTooltipQuery, unfullscreen, unmap, unmaximize, unparent, unrealize, unref, unregisterWindow, unsetFocusChain, unsetStateFlags, unstick, updateButtonsState, watchClosure.

Getters

getAcceptFocus, getAccessible, getActionGroup, getAllocatedBaseline, getAllocatedHeight, getAllocatedSize, getAllocatedWidth, getAllocation, getAncestor, getAppPaintable, getApplication, getAttachedTo, getBorderWidth, getCanDefault, getCanFocus, getChild, getChildRequisition, getChildVisible, getChildren, getClip, getClipboard, getCompositeName, getCurrentPage, getData, getDecorated, getDefaultSize, getDefaultWidget, getDeletable, getDestroyWithParent, getDeviceEnabled, getDeviceEvents, getDirection, getDisplay, getDoubleBuffered, getEvents, getFocus, getFocusChain, getFocusChild, getFocusHadjustment, getFocusOnClick, getFocusOnMap, getFocusVadjustment, getFocusVisible, getFontMap, getFontOptions, getFrameClock, getGravity, getGroup, getHalign, getHasResizeGrip, getHasTooltip, getHasWindow, getHexpand, getHexpandSet, getHideTitlebarWhenMaximized, getIcon, getIconList, getIconName, getInternalChild, getMapped, getMarginBottom, getMarginEnd, getMarginLeft, getMarginRight, getMarginStart, getMarginTop, getMnemonicModifier, getMnemonicsVisible, getModal, getModifierMask, getModifierStyle, getNPages, getName, getNoShowAll, getNthPage, getOpacity, getPageComplete, getPageHasPadding, getPageHeaderImage, getPageSideImage, getPageTitle, getPageType, getPangoContext, getParent, getParentWindow, getPath, getPathForChild, getPointer, getPosition, getPreferredHeight, getPreferredHeightAndBaselineForWidth, getPreferredHeightForWidth, getPreferredSize, getPreferredWidth, getPreferredWidthForHeight, getProperty, getQdata, getRealized, getReceivesDefault, getRequestMode, getRequisition, getResizable, getResizeGripArea, getResizeMode, getRole, getRootWindow, getScaleFactor, getScreen, getSensitive, getSettings, getSize, getSizeRequest, getSkipPagerHint, getSkipTaskbarHint, getState, getStateFlags, getStyle, getStyleContext, getSupportMultidevice, getTemplateChild, getTitle, getTitlebar, getTooltipMarkup, getTooltipText, getTooltipWindow, getToplevel, getTransientFor, getTypeHint, getUrgencyHint, getValign, getValignWithBaseline, getVexpand, getVexpandSet, getVisible, getVisual, getWindow, getWindowType.

Setters

setAccelPath, setAcceptFocus, setAllocation, setAppPaintable, setApplication, setAttachedTo, setBorderWidth, setBuildableProperty, setCanDefault, setCanFocus, setChildVisible, setClip, setCompositeName, setCurrentPage, setData, setDataFull, setDecorated, setDefault, setDefaultGeometry, setDefaultSize, setDeletable, setDestroyWithParent, setDeviceEnabled, setDeviceEvents, setDirection, setDoubleBuffered, setEvents, setFocus, setFocusChain, setFocusChild, setFocusHadjustment, setFocusOnClick, setFocusOnMap, setFocusVadjustment, setFocusVisible, setFontMap, setFontOptions, setForwardPageFunc, setGeometryHints, setGravity, setHalign, setHasResizeGrip, setHasTooltip, setHasUserRefCount, setHasWindow, setHexpand, setHexpandSet, setHideTitlebarWhenMaximized, setIcon, setIconFromFile, setIconList, setIconName, setKeepAbove, setKeepBelow, setMapped, setMarginBottom, setMarginEnd, setMarginLeft, setMarginRight, setMarginStart, setMarginTop, setMnemonicModifier, setMnemonicsVisible, setModal, setName, setNoShowAll, setOpacity, setPageComplete, setPageHasPadding, setPageHeaderImage, setPageSideImage, setPageTitle, setPageType, setParent, setParentWindow, setPosition, setProperty, setRealized, setReallocateRedraws, setReceivesDefault, setRedrawOnAllocate, setResizable, setResizeMode, setRole, setScreen, setSensitive, setSizeRequest, setSkipPagerHint, setSkipTaskbarHint, setStartupId, setState, setStateFlags, setStyle, setSupportMultidevice, setTitle, setTitlebar, setTooltipMarkup, setTooltipText, setTooltipWindow, setTransientFor, setTypeHint, setUrgencyHint, setValign, setVexpand, setVexpandSet, setVisible, setVisual, setWindow, setWmclass.

addActionWidget

assistantAddActionWidget

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

child: a Widget

-> m ()

Adds a widget to the action area of a Assistant.

Since: 2.10

appendPage

assistantAppendPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a Widget

-> m Int32

Returns: the index (starting at 0) of the inserted page

Appends a page to the assistant.

Since: 2.10

commit

assistantCommit

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m ()

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

Use this when the information provided up to the current page is hereafter deemed permanent and cannot be modified or undone. For example, showing a progress page to track a long-running, unreversible operation after the user has clicked apply on a confirmation page.

Since: 2.22

getCurrentPage

assistantGetCurrentPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m Int32

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.

Returns the page number of the current page.

Since: 2.10

getNPages

assistantGetNPages

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m Int32

Returns: the number of pages in the assistant

Returns the number of pages in the assistant

Since: 2.10

getNthPage

assistantGetNthPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> Int32

pageNum: the index of a page in the assistant, or -1 to get the last page

-> m (Maybe Widget)

Returns: the child widget, or Nothing if pageNum is out of bounds

Returns the child widget contained in page number pageNum.

Since: 2.10

getPageComplete

assistantGetPageComplete

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m Bool

Returns: True if page is complete.

Gets whether page is complete.

Since: 2.10

getPageHasPadding

assistantGetPageHasPadding

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m Bool

Returns: True if page has padding

Gets whether page has padding.

Since: 3.18

getPageHeaderImage

assistantGetPageHeaderImage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m Pixbuf

Returns: the header image for page, or Nothing if there’s no header image for the page

Deprecated: (Since version 3.2)Since GTK+ 3.2, a header is no longer shown; add your header decoration to the page content instead.

Gets the header image for page.

Since: 2.10

getPageSideImage

assistantGetPageSideImage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m Pixbuf

Returns: the side image for page, or Nothing if there’s no side image for the page

Deprecated: (Since version 3.2)Since GTK+ 3.2, sidebar images are not shown anymore.

Gets the side image for page.

Since: 2.10

getPageTitle

assistantGetPageTitle

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m Text

Returns: the title for page

Gets the title for page.

Since: 2.10

getPageType

assistantGetPageType

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> m AssistantPageType

Returns: the page type of page

Gets the page type of page.

Since: 2.10

insertPage

assistantInsertPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a Widget

-> Int32

position: the index (starting at 0) at which to insert the page, or -1 to append the page to the assistant

-> m Int32

Returns: the index (starting from 0) of the inserted page

Inserts a page in the assistant at a given position.

Since: 2.10

new

assistantNew

Arguments

:: (HasCallStack, MonadIO m)

=> m Assistant

Returns: a newly created Assistant

Creates a new Assistant.

Since: 2.10

nextPage

assistantNextPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m ()

Navigate to the next page.

It is a programming error to call this function when there is no next page.

This function is for use when creating pages of the GTK_ASSISTANT_PAGE_CUSTOM type.

Since: 3.0

prependPage

assistantPrependPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a Widget

-> m Int32

Returns: the index (starting at 0) of the inserted page

Prepends a page to the assistant.

Since: 2.10

previousPage

assistantPreviousPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m ()

Navigate to the previous visited page.

It is a programming error to call this function when no previous page is available.

This function is for use when creating pages of the GTK_ASSISTANT_PAGE_CUSTOM type.

Since: 3.0

removeActionWidget

assistantRemoveActionWidget

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

child: a Widget

-> m ()

Removes a widget from the action area of a Assistant.

Since: 2.10

removePage

assistantRemovePage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> Int32

pageNum: the index of a page in the assistant, or -1 to remove the last page

-> m ()

Removes the pageNum’s page from assistant.

Since: 3.2

setCurrentPage

assistantSetCurrentPage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> Int32

pageNum: index of the page to switch to, starting from 0. If negative, the last page will be used. If greater than the number of pages in the assistant, nothing will be done.

-> m ()

Switches the page to pageNum.

Note that this will only be necessary in custom buttons, as the assistant flow can be set with assistantSetForwardPageFunc.

Since: 2.10

setForwardPageFunc

assistantSetForwardPageFunc

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> Maybe AssistantPageFunc

pageFunc: the AssistantPageFunc, or Nothing to use the default one

-> m ()

Sets the page forwarding function to be pageFunc.

This function will be used to determine what will be the next page when the user presses the forward button. Setting pageFunc to Nothing will make the assistant to use the default forward function, which just goes to the next visible page.

Since: 2.10

setPageComplete

assistantSetPageComplete

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> Bool

complete: the completeness status of the page

-> m ()

Sets whether page contents are complete.

This will make assistant update the buttons state to be able to continue the task.

Since: 2.10

setPageHasPadding

assistantSetPageHasPadding

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> Bool

hasPadding: whether this page has padding

-> m ()

Sets whether the assistant is adding padding around the page.

Since: 3.18

setPageHeaderImage

assistantSetPageHeaderImage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b, IsPixbuf c)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> Maybe c

pixbuf: the new header image page

-> m ()

Deprecated: (Since version 3.2)Since GTK+ 3.2, a header is no longer shown; add your header decoration to the page content instead.

Sets a header image for page.

Since: 2.10

setPageSideImage

assistantSetPageSideImage

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b, IsPixbuf c)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> Maybe c

pixbuf: the new side image page

-> m ()

Deprecated: (Since version 3.2)Since GTK+ 3.2, sidebar images are not shown anymore.

Sets a side image for page.

This image used to be displayed in the side area of the assistant when page is the current page.

Since: 2.10

setPageTitle

assistantSetPageTitle

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> Text

title: the new title for page

-> m ()

Sets a title for page.

The title is displayed in the header area of the assistant when page is the current page.

Since: 2.10

setPageType

assistantSetPageType

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a, IsWidget b)

=> a

assistant: a Assistant

-> b

page: a page of assistant

-> AssistantPageType

type: the new type for page

-> m ()

Sets the page type for page.

The page type determines the page behavior in the assistant.

Since: 2.10

updateButtonsState

assistantUpdateButtonsState

Arguments

:: (HasCallStack, MonadIO m, IsAssistant a)

=> a

assistant: a Assistant

-> m ()

Forces assistant to recompute the buttons state.

GTK+ automatically takes care of this in most situations, e.g. when the user goes to a different page, or when the visibility or completeness of a page changes.

One situation where it can be necessary to call this function is when changing a value on the current page affects the future page flow of the assistant.

Since: 2.10

Properties

useHeaderBar

True if the assistant uses a HeaderBar for action buttons instead of the action-area.

For technical reasons, this property is declared as an integer property, but you should only set it to True or False.

Since: 3.12

constructAssistantUseHeaderBar :: (IsAssistant o, MonadIO m) => Int32 -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “use-header-bar” property. This is rarely needed directly, but it is used by new.

getAssistantUseHeaderBar :: (MonadIO m, IsAssistant o) => o -> m Int32

Get the value of the “use-header-bar” property. When overloading is enabled, this is equivalent to

get assistant #useHeaderBar

Signals

apply

type AssistantApplyCallback = IO ()

The apply signal is emitted when the apply button is clicked.

The default behavior of the Assistant is to switch to the page after the current page, unless the current page is the last one.

A handler for the apply signal should carry out the actions for which the wizard has collected data. If the action takes a long time to complete, you might consider putting a page of type AssistantPageTypeProgress after the confirmation page and handle this operation within the Assistant::prepare signal of the progress page.

Since: 2.10

afterAssistantApply :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantApplyCallback) -> m SignalHandlerId

Connect a signal handler for the apply signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after assistant #apply callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onAssistantApply :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantApplyCallback) -> m SignalHandlerId

Connect a signal handler for the apply signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on assistant #apply callback

cancel

type AssistantCancelCallback = IO ()

The cancel signal is emitted when then the cancel button is clicked.

Since: 2.10

afterAssistantCancel :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantCancelCallback) -> m SignalHandlerId

Connect a signal handler for the cancel signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after assistant #cancel callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onAssistantCancel :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantCancelCallback) -> m SignalHandlerId

Connect a signal handler for the cancel signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on assistant #cancel callback

close

type AssistantCloseCallback = IO ()

The close signal is 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 AssistantPageTypeConfirm) is clicked.

Since: 2.10

afterAssistantClose :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantCloseCallback) -> m SignalHandlerId

Connect a signal handler for the close signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after assistant #close callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onAssistantClose :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantCloseCallback) -> m SignalHandlerId

Connect a signal handler for the close signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on assistant #close callback

escape

type AssistantEscapeCallback = IO ()

No description available in the introspection data.

afterAssistantEscape :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantEscapeCallback) -> m SignalHandlerId

Connect a signal handler for the escape signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after assistant #escape callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onAssistantEscape :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantEscapeCallback) -> m SignalHandlerId

Connect a signal handler for the escape signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on assistant #escape callback

prepare

type AssistantPrepareCallback

Arguments

 = Widget

page: the current page

-> IO ()

The prepare signal is emitted when a new page is set as the assistant's current page, before making the new page visible.

A handler for this signal can do any preparations which are necessary before showing page.

Since: 2.10

afterAssistantPrepare :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantPrepareCallback) -> m SignalHandlerId

Connect a signal handler for the prepare signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after assistant #prepare callback

By default the object invoking the signal is not passed to the callback. If you need to access it, you can use the implit ?self parameter. Note that this requires activating the ImplicitParams GHC extension.

onAssistantPrepare :: (IsAssistant a, MonadIO m) => a -> ((?self :: a) => AssistantPrepareCallback) -> m SignalHandlerId

Connect a signal handler for the prepare signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on assistant #prepare callback