Class Wiz_window

Known Subclasses:

• peak_intensity.Peak_intensity_wizard

The wizard.

Instance Methods

__init__(self, parent=None, size_x=400, size_y=400, title='', border=10, style=wx.DEFAULT_DIALOG_STYLE)
Set up the window.

_apply(self, event=None)
Execute the current page's 'Apply' method.

_build_buttons(self)
Construct the buttons for all pages of the wizard.

_cancel(self, event=None)
Cancel the operation.

_display_page(self, i)
Display the given page.

_go_back(self, event=None)
Return to the previous page.

_go_next(self, event=None)
Move to the next page.

_handler_close(self, event=None)
Event handler for the close window action.

_handler_escape(self, event=None)
Event handler for key strokes.

int _next_fn(self)
Standard function for setting the next page to the one directly next in the sequence.

_ok(self, event=None)
Accept the operation.

_seq_loop(self)
Loop over the sequence in the forwards direction.

_skip(self, event=None)
Skip the page.

Destroy(self)
Override the default wx.Dialog.Destroy() method.

int add_page(self, panel, apply_button=True, skip_button=False, exec_on_next=True, proceed_on_error=True, uf_flush=False)
Add a new page to the wizard.

block_next(self, block=True)
Prevent moving forwards (or unblock).

Wiz_page instance. get_page(self, index)
Get a page from the wizard.

reset(self)
Reset the wizard.

bool or None run(self, modal=False)
Execute the wizard.

set_seq_next_fn(self, index, fn)
A user specified function for non-linear page changing.

setup_page(self, page=None, **kargs)
Allow a specified user function page to be remotely set up.

Class Variables

_size_button = 100, 33

ICON_APPLY = fetch_icon('oxygen.actions.dialog-ok-apply', "22x...

ICON_BACK = fetch_icon('oxygen.actions.go-previous-view', "22x...

ICON_CANCEL = fetch_icon('oxygen.actions.dialog-cancel', "22x22")

ICON_FINISH = fetch_icon('oxygen.actions.dialog-ok', "22x22")

ICON_NEXT = fetch_icon('oxygen.actions.go-next-view', "22x22")

ICON_OK = fetch_icon('oxygen.actions.dialog-ok', "22x22")

ICON_SKIP = fetch_icon('oxygen.actions.arrow-right-double-rela...

TEXT_APPLY = " Apply"

TEXT_BACK = " Back"

TEXT_CANCEL = " Cancel"

TEXT_FINISH = " Finish"

TEXT_NEXT = " Next"

TEXT_OK = " OK"

TEXT_SKIP = " Skip"

Method Details

__init__(self, parent=None, size_x=400, size_y=400, title='', border=10, style=wx.DEFAULT_DIALOG_STYLE)
(Constructor)

Set up the window.

Parameters:

• parent (wx.Window instance) - The parent window.
• size_x (int) - The width of the wizard.
• size_y (int) - The height of the wizard.
• title (str) - The title of the wizard dialog.
• border (int) - The size of the border inside the wizard.
• style (wx style) - The dialog style.

_apply(self, event=None)

Execute the current page's 'Apply' method.

Parameters:

• event (wx event) - The wx event.

_cancel(self, event=None)

Cancel the operation.

Parameters:

• event (wx event) - The wx event.

_display_page(self, i)

Display the given page.

Parameters:

• i (int) - The index of the page to display.

_go_back(self, event=None)

Return to the previous page.

Parameters:

• event (wx event) - The wx event.

_go_next(self, event=None)

Move to the next page.

Parameters:

• event (wx event) - The wx event.

_handler_close(self, event=None)

Event handler for the close window action.

Parameters:

• event (wx event) - The wx event.

_handler_escape(self, event=None)

Event handler for key strokes.

Parameters:

• event (wx event) - The wx event.

_next_fn(self)

Standard function for setting the next page to the one directly next in the sequence.

Returns: int

The index of the next page, which is the current page index plus one.

_ok(self, event=None)

Accept the operation.

Parameters:

• event (wx event) - The wx event.

_skip(self, event=None)

Skip the page.

Parameters:

• event (wx event) - The wx event.

add_page(self, panel, apply_button=True, skip_button=False, exec_on_next=True, proceed_on_error=True, uf_flush=False)

Add a new page to the wizard.

Parameters:

• panel (wx.Panel instance) - The page to add to the wizard.
• apply_button (bool) - A flag which if true will show the apply button for that page.
• skip_button (bool) - A flag which if true will show the skip button for that page.
• exec_on_next (bool) - A flag which if true will run the on_execute() method when clicking on the next button.
• proceed_on_error (bool) - A flag which if True will proceed to the next page (or quit if there are no more pages) despite the occurrence of an error in execution. If False, the page will remain open (the GUI interpreter thread will be flushed first to synchronise).
• uf_flush (bool) - A flag which if True will cause the GUI interpreter thread to be flushed to clear out all user function call prior to proceeding.

Returns: int

The index of the page in the wizard.

block_next(self, block=True)

Prevent moving forwards (or unblock).

Parameters:

• block (bool) - A flag which if True will block forwards movement and if False will unblock.

get_page(self, index)

Get a page from the wizard.

Parameters:

• index (int) - The index of the page.

Returns: Wiz_page instance.

The page object.

run(self, modal=False)

Execute the wizard.

Parameters:

• modal (bool) - A flag which if True will cause the wizard to be run as a modal dialog.

Returns: bool or None

The status from the modal operation, i.e. True if the wizard is run, False if cancelled or other error occur. For modeless operation, this returns nothing.

set_seq_next_fn(self, index, fn)

A user specified function for non-linear page changing.

Parameters:

• index (int) - The index of the page the function should be associated with.
• fn (func or method.) - The function for determining the page after the current. This function should return the index of the next page.

setup_page(self, page=None, **kargs)

Allow a specified user function page to be remotely set up.

Parameters:

• page (str) - The page to setup. This is the page index key.

Class Variable Details

ICON_APPLY

Value:

fetch_icon('oxygen.actions.dialog-ok-apply', "22x22")

ICON_BACK

Value:

fetch_icon('oxygen.actions.go-previous-view', "22x22")

ICON_SKIP

Value:

fetch_icon('oxygen.actions.arrow-right-double-relax-blue', "22x22")