BiWizard

This component creates a dialog that contains a BiWizardPane. The wizard pane provides buttons for navigating back and forth and finishing and canceling the wizard.

Any BiComponent may be used as a page. Use addPage to add pages to the wizard. The pages dispatch activated and deactivated when the active page changes. You can also use the change event to get notifications about when the user changes the active page.

Most of the methods and properties provided by the BiWizardPane are also available on the wizard dialog.

This class extends BiDialog and therefore all methods and fields available for BiDialog are also available for BiWizard .

Constructor

new BiWizard ( sCaption )

Parameters

Name	Type	Optional	Default	Descripton
sCaption	String			Optional caption text for the dialog.

Properties

Name	Type	get	set	Descripton
backdropImage	BiImage			The image used as the backdrop on the left side of the wizard pane.
pages	BiComponent[]			Returns all the pages currently in the wizard.
selectedIndex	Number			The index of the selected page. If no page is selected this returns -1.
selectedPage	BiComponent			The currently selected page.
stringBundle	BiStringBundle			The string bundle to use for this wizard dialog. For keys to use in the string bundle see BiWizardPane.

Methods

Name	Description
addPage	This adds a page to the wizard pane.
back	Goes to the previous page.
cancel	This is called when the user presses the cancel button.
finish	This is called when the user presses the finish button.
next	Goes to the next page.
removePage	This removes a page from the wizard pane.

Events

Name	Type	Bubbles	Descripton
back	BiEvent		Fires when the selectedPage changes to the previous page.
beforeback	BiEvent		Fires before the selectedPage changes to the previous page. Call preventDefault on the event object to prevent the wizard to change the page.
beforecancel	BiEvent		Fires before the the wizard's cancel event is called. Calling preventDefault on the event object will prevent the wizard from dispatching the cancel event.
beforechange	BiEvent		Fires before the selectedPage page changes. Call preventDefault on the event object to prevent the wizard to change the page.
beforefinish	BiEvent		Fires before the the wizard's finish event is called. Calling preventDefault on the event object will prevent the wizard from dispatching the finish event.
beforenext	BiEvent		Fires before the selectedPage changes to the next page. Call preventDefault on the event object to prevent the wizard to change the page.
cancel	BiEvent		This event is dispatched when the user clicks the cancel button.
change	BiEvent		Fires when the selectedPage page changes.
finish	BiEvent		This event is dispatched when the user clicks the finish button.
next	BiEvent		Fires when the selectedPage changes to the next page.

Static Methods

None.

Static Fields

None.

Remarks

None.

Method Details

addPage

This adds a page to the wizard pane.

Syntax

object.addPage ( oPage,oBefore )

Parameters

Name	Type	Optional	Default	Descripton
oPage	BiComponent			The page to add
oBefore	BiComponent			Optional and if provided the new page will be added before this one.

Return Type

void

back

Goes to the previous page.

Syntax

object.back ( )

Parameters

No arguments.

Return Type

void

cancel

This is called when the user presses the cancel button.

Syntax

object.cancel ( )

Parameters

No arguments.

Return Type

void

finish

This is called when the user presses the finish button.

Syntax

object.finish ( )

Parameters

No arguments.

Return Type

void

next

Goes to the next page.

Syntax

object.next ( )

Parameters

No arguments.

Return Type

void

removePage

This removes a page from the wizard pane.

Syntax

object.removePage ( oPage )

Parameters

Name	Type	Optional	Default	Descripton
oPage	BiComponent			The page to remove.

Return Type

BiComponent