Wizard Class

[ToolboxBitmap(typeof(Wizard))]
public class Wizard : UIContainerControl, IUIControl, IUIElement, ILogicalTreeNode, IDpiAwareElement, IDisposable, ICommandTarget

public Wizard()

Remarks

The default constructor initializes all fields to their default values.

See Also

• WizardPage

[Browsable(false)]
public Button BackButton { get; }

Property Value

Button:

The Button instance that is used for the Back button.

Remarks

Use this property to directly access the Button control, allowing for advanced customization.

See Also

• WizardPage

public Color BackButtonBackColor { get; set; }

Property Value

Color:

The background color of the Back button.

See Also

• WizardPage

public bool BackButtonCausesValidation { get; set; }

Property Value

bool:

true if validation is performed when the Back button is clicked; otherwise, false. The default value is false.

See Also

• WizardPage

[Browsable(false)]
public bool BackButtonEnabled { get; set; }

Property Value

bool:

true if the button is enabled; otherwise, false.

See Also

• WizardPage

public int BackButtonTabIndex { get; set; }

Property Value

int:

The tab order of the Back button within its container.

See Also

• WizardPage

public bool BackButtonTabStop { get; set; }

Property Value

bool:

true if the button has a tab stop; otherwise, false.

See Also

• WizardPage

public string BackButtonText { get; set; }

Property Value

string:

The text displayed on the button.

See Also

• WizardPage

public int BackButtonWidth { get; set; }

Property Value

int:

The width of the button.

See Also

• WizardPage

public FlatStyle ButtonFlatStyle { get; set; }

Property Value

FlatStyle:

A FlatStyle specifying the flat style appearance of the buttons in the wizard.

See Also

• WizardPage

public int ButtonHeight { get; set; }

Property Value

int:

The height of the buttons.

See Also

• WizardPage

[Browsable(false)]
public Button CancelButton { get; }

Property Value

Button:

The Button instance that is used for the Cancel button.

Remarks

Use this property to directly access the Button control, allowing for advanced customization.

See Also

• WizardPage

public Color CancelButtonBackColor { get; set; }

Property Value

Color:

The background color of the Cancel button.

See Also

• WizardPage

public bool CancelButtonCausesValidation { get; set; }

Property Value

bool:

true if validation is performed when the Cancel button is clicked; otherwise, false. The default value is false.

See Also

• WizardPage

public DialogResult CancelButtonDialogResult { get; set; }

Property Value

DialogResult:

The DialogResult for the Cancel button. The default value is DialogResult.Cancel.

See Also

• WizardPage

[Browsable(false)]
public bool CancelButtonEnabled { get; set; }

Property Value

bool:

true if the button is enabled; otherwise, false.

See Also

• WizardPage

public int CancelButtonTabIndex { get; set; }

Property Value

int:

The tab order of the Cancel button within its container.

See Also

• WizardPage

public bool CancelButtonTabStop { get; set; }

Property Value

bool:

true if the button has a tab stop; otherwise, false.

See Also

• WizardPage

public string CancelButtonText { get; set; }

Property Value

string:

The text displayed on the button.

See Also

• WizardPage

public int CancelButtonWidth { get; set; }

Property Value

int:

The width of the button.

See Also

• WizardPage

[Browsable(false)]
public CommandLinkCollection CommandLinks { get; }

Property Value

CommandLinkCollection:

A CommandLinkCollection containing the command links associated with the object.

See Also

• WizardPage

[Browsable(false)]
public Control.ControlCollection Controls { get; }

Property Value

Control.ControlCollection:

The ControlCollection that contains the child controls of the wizard.

See Also

• WizardPage

protected override Size DefaultSize { get; }

Property Value

Size:

The default Size of the control.

See Also

• WizardPage

public bool DisableButtonsDuringPageChange { get; set; }

Property Value

bool:

true if wizard buttons should be disabled during page changes; otherwise, false.

Remarks

When a page change occurs, if this property is set to true, all the buttons are disabled until the page change is complete. The mouse cursor is also set to a wait cursor during the page change.

See Also

• WizardPage

[Browsable(false)]
public Rectangle ExteriorPageBounds { get; }

Property Value

Rectangle:

A Rectangle specifying the bounds of interior pages.

See Also

• WizardPage

[Browsable(false)]
public Button FinishButton { get; }

Property Value

Button:

The Button instance that is used for the Finish button.

Remarks

Use this property to directly access the Button control, allowing for advanced customization.

See Also

• WizardPage

public Color FinishButtonBackColor { get; set; }

Property Value

Color:

The background color of the Finish button.

See Also

• WizardPage

public bool FinishButtonCausesValidation { get; set; }

Property Value

bool:

true if validation is performed when the Finish button is clicked; otherwise, false. The default value is true.

See Also

• WizardPage

public DialogResult FinishButtonDialogResult { get; set; }

Property Value

DialogResult:

The DialogResult for the Finish button. The default value is DialogResult.OK.

See Also

• WizardPage

public bool FinishButtonDistinct { get; set; }

Property Value

bool:

true if the Finish button should always appear on its own; otherwise, false.

Remarks

This property should be set to true for wizards that have pages with the Next and Finish buttons enabled. Otherwise, the property should be set to false to adhere to the Wizard97 specification.

See Also

• WizardPage

[Browsable(false)]
public bool FinishButtonEnabled { get; set; }

Property Value

bool:

true if the button is enabled; otherwise, false.

See Also

• WizardPage

public int FinishButtonTabIndex { get; set; }

Property Value

int:

The tab order of the Finish button within its container.

See Also

• WizardPage

public bool FinishButtonTabStop { get; set; }

Property Value

bool:

true if the button has a tab stop; otherwise, false.

See Also

• WizardPage

public string FinishButtonText { get; set; }

Property Value

string:

The text displayed on the button.

See Also

• WizardPage

public int FinishButtonWidth { get; set; }

Property Value

int:

The width of the button.

See Also

• WizardPage

[Browsable(true)]
public override Font Font { get; set; }

Property Value

Font:

The Font to use for text in the control.

See Also

• WizardPage

public WizardAcceptButtonDefault FormAcceptButton { get; set; }

Property Value

WizardAcceptButtonDefault:

A WizardAcceptButtonDefault specifying the accept button for the wizard.

See Also

• WizardPage

public WizardCancelButtonDefault FormCancelButton { get; set; }

Property Value

WizardCancelButtonDefault:

A WizardCancelButtonDefault specifying the cancel button for the wizard.

See Also

• WizardPage

[Browsable(false)]
public ICommandTarget ForwardCommandsTo { get; set; }

Property Value

ICommandTarget:

The ICommandTarget to forward commands to.

See Also

• WizardPage

[Browsable(false)]
public Button HelpButton { get; }

Property Value

Button:

The Button instance that is used for the Help button.

Remarks

Use this property to directly access the Button control, allowing for advanced customization.

See Also

• WizardPage

public bool HelpButtonAlignLeft { get; set; }

Property Value

bool:

true if the Help button is aligned to the left side of the wizard; otherwise, false.

See Also

• WizardPage

public Color HelpButtonBackColor { get; set; }

Property Value

Color:

The background color of the Help button.

See Also

• WizardPage

public bool HelpButtonCausesValidation { get; set; }

Property Value

bool:

true if validation is performed when the Help button is clicked; otherwise, false. The default value is false.

See Also

• WizardPage

[Browsable(false)]
public bool HelpButtonEnabled { get; set; }

Property Value

bool:

true if the button is enabled; otherwise, false.

See Also

• WizardPage

public int HelpButtonTabIndex { get; set; }

Property Value

int:

The tab order of the Help button within its container.

See Also

• WizardPage

public bool HelpButtonTabStop { get; set; }

Property Value

bool:

true if the button has a tab stop; otherwise, false.

See Also

• WizardPage

public string HelpButtonText { get; set; }

Property Value

string:

The text displayed on the button.

See Also

• WizardPage

public int HelpButtonWidth { get; set; }

Property Value

int:

The width of the button.

See Also

• WizardPage

[Browsable(false)]
public Rectangle InteriorPageBounds { get; }

Property Value

Rectangle:

A Rectangle specifying the bounds of interior pages.

See Also

• WizardPage

public int InteriorPageGuideLineCount { get; set; }

Property Value

int:

The number of interior page guide lines to display in design-time mode.

Remarks

Set this property to 0 to display no guide lines.

See Also

• WizardPage

[Browsable(false)]
public Button NextButton { get; }

Property Value

Button:

The Button instance that is used for the Next button.

Remarks

Use this property to directly access the Button control, allowing for advanced customization.

See Also

• WizardPage

public Color NextButtonBackColor { get; set; }

Property Value

Color:

The background color of the Next button.

See Also

• WizardPage

public bool NextButtonCausesValidation { get; set; }

Property Value

bool:

true if validation is performed when the Next button is clicked; otherwise, false. The default value is true.

See Also

• WizardPage

[Browsable(false)]
public bool NextButtonEnabled { get; set; }

Property Value

bool:

true if the button is enabled; otherwise, false.

See Also

• WizardPage

public int NextButtonTabIndex { get; set; }

Property Value

int:

The tab order of the Next button within its container.

See Also

• WizardPage

public bool NextButtonTabStop { get; set; }

Property Value

bool:

true if the button has a tab stop; otherwise, false.

See Also

• WizardPage

public string NextButtonText { get; set; }

Property Value

string:

The text displayed on the button.

See Also

• WizardPage

public int NextButtonWidth { get; set; }

Property Value

int:

The width of the button.

See Also

• WizardPage

public WizardPageSequenceType PageSequenceType { get; set; }

Property Value

WizardPageSequenceType:

A WizardPageSequenceType specifying the type of page sequencing to perform.

See Also

• WizardPage

public WizardPageCollection Pages { get; }

Property Value

WizardPageCollection:

A WizardPageCollection representing the pages in the Wizard.

Remarks

This property enables you to obtain a reference to the list of pages that are currently stored in the Wizard. With this reference, you can add pages, remove pages, and obtain a count of the pages in the collection. For more information on the tasks that can be performed with the Pages collection, see the WizardPageCollection class reference topics.

See Also

• WizardPage

public IWizardRenderer Renderer { get; set; }

Property Value

IWizardRenderer:

The IWizardRenderer used to render the control.

See Also

• WizardPage

[Browsable(false)]
public int SelectedIndex { get; set; }

Property Value

int:

The index of the selected item. If there are no items in the control, this property returns -1.

Remarks

The index is zero-based.

See Also

• WizardPage

[Browsable(false)]
public WizardPage SelectedPage { get; set; }

Property Value

WizardPage:

The WizardPage that is currently selected. null is returned if there is no page currently selected.

See Also

• WizardPage

protected override bool UseExtendedDoubleBuffering { get; }

Property Value

bool:

true if extended double buffering should be used; otherwise, false.

See Also

• WizardPage

protected override Size ArrangeOverride(Size finalSize)

Parameter	Type	Description
finalSize	Size	The final area within the parent that this element should use to arrange itself and its children.

Returns

Size:

The actual size used.

Remarks

Element authors should override this method, call Arrange on each visible child element and position each child element. It is required that a parent element calls Arrange on each child or they won't be rendered.

See Also

• WizardPage

protected override IList CreateChildren()

Returns

IList:

The IList that should be assigned to the Children property.

Remarks

By default no child collection is created.

See Also

• WizardPage

protected override Control.ControlCollection CreateControlsInstance()

Returns

Control.ControlCollection:

A new instance of a Control.ControlCollection assigned to the control.

See Also

• WizardPage

protected override void Dispose(bool disposing)

Parameter	Type	Description
disposing	bool	Whether the object is being disposed.

See Also

• WizardPage

public void EndInitialization()

See Also

• WizardPage

protected override PointHitTestResult HitTest(PointHitTestParameters hitTestParams, Func<IUIElement, PointHitTestParameters, bool> filter)

Parameter	Type	Description
hitTestParams	PointHitTestParameters	A PointHitTestParameters containing hit test parameters.
filter	Func<IUIElement, PointHitTestParameters, bool>	Optionally defines a filter which must return true for an element to match the hit test.

Returns

PointHitTestResult:

A PointHitTestResult containing the hit test result.

See Also

• WizardPage

protected override PointHitTestResult HitTestRecursive(PointHitTestParameters hitTestParams, Func<IUIElement, PointHitTestParameters, bool> filter)

Parameter	Type	Description
hitTestParams	PointHitTestParameters	A PointHitTestParameters containing hit test parameters.
filter	Func<IUIElement, PointHitTestParameters, bool>	Optionally defines a filter which must return true for an element to match the hit test.

Returns

PointHitTestResult:

A PointHitTestResult containing the hit test result.

See Also

• WizardPage

protected virtual void OnBackButtonClick(WizardPageCancelEventArgs e)

Parameter	Type	Description
e	WizardPageCancelEventArgs	A WizardPageCancelEventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnButtonMouseEnter(WizardButtonEventArgs e)

Parameter	Type	Description
e	WizardButtonEventArgs	A WizardButtonEventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnButtonMouseLeave(WizardButtonEventArgs e)

Parameter	Type	Description
e	WizardButtonEventArgs	A WizardButtonEventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnCancelButtonClick(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnFinishButtonClick(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnHelpButtonClick(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnLayoutButtons(WizardLayoutButtonsEventArgs e)

Parameter	Type	Description
e	WizardLayoutButtonsEventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected override void OnMouseDown(MouseEventArgs e)

Parameter	Type	Description
e	MouseEventArgs	A MouseEventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnNextButtonClick(WizardPageCancelEventArgs e)

Parameter	Type	Description
e	WizardPageCancelEventArgs	A WizardPageCancelEventArgs that contains the event data.

See Also

• WizardPage

protected override void OnParentChanged(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected override void OnRender(PaintEventArgs e)

Parameter	Type	Description
e	PaintEventArgs	A PaintEventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnSelectionChanged(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

protected virtual void OnSelectionChanging(WizardPageCancelEventArgs e)

Parameter	Type	Description
e	WizardPageCancelEventArgs	A WizardPageCancelEventArgs that contains the event data.

See Also

• WizardPage

protected override void OnVisibleChanged(EventArgs e)

Parameter	Type	Description
e	EventArgs	An EventArgs that contains the event data.

See Also

• WizardPage

public void PerformBackButtonClick()

See Also

• WizardPage

public void PerformCancelButtonClick()

See Also

• WizardPage

public void PerformFinishButtonClick()

See Also

• WizardPage

public void PerformHelpButtonClick()

See Also

• WizardPage

public void PerformNextButtonClick()

See Also

• WizardPage

protected override bool ProcessDialogKey(Keys keyData)

Parameter	Type	Description
keyData	Keys	One of the Keys values that represents the key to process.

Returns

bool:

true if the key was processed by the control; otherwise, false.

See Also

• WizardPage

protected override bool ProcessTabKey(bool forward)

Parameter	Type	Description
forward	bool	true to cycle forward through the controls in the ContainerControl; otherwise, false.

Returns

bool:

true if a control is selected; otherwise, false.

See Also

• WizardPage

public virtual bool RaiseCommand(Command command)

Parameter	Type	Description
command	Command	The Command to raise.

Returns

bool:

true if the Command was handled; otherwise, false.

See Also

• WizardPage

public void ResetBackButtonBackColor()

See Also

• WizardPage

public void ResetCancelButtonBackColor()

See Also

• WizardPage

public void ResetFinishButtonBackColor()

See Also

• WizardPage

public void ResetHelpButtonBackColor()

See Also

• WizardPage

public void ResetNextButtonBackColor()

See Also

• WizardPage

public virtual void ResetRenderer()

See Also

• WizardPage

public bool ShouldSerializeBackButtonBackColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

public bool ShouldSerializeCancelButtonBackColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

public bool ShouldSerializeFinishButtonBackColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

public bool ShouldSerializeHelpButtonBackColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

public bool ShouldSerializeNextButtonBackColor()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

public bool ShouldSerializePages()

Returns

bool:

true if the pages collection should be serialized; otherwise false.

See Also

• WizardPage

public virtual bool ShouldSerializeRenderer()

Returns

bool:

true if the property value has changed from its default; otherwise, false.

See Also

• WizardPage

protected override void WndProc(ref Message m)

Parameter	Type	Description
m	Message	The Windows Message to process.

See Also

• WizardPage

public event WizardPageCancelEventHandler BackButtonClick

Event Type

WizardPageCancelEventHandler

Remarks

By default, the Wizard will move to the previous WizardPage in the WizardPageCollection after this event fires. To cancel this behavior, set the Cancel property of the event argument to true. Then you can use the SelectedPage property to set the WizardPage that should be displayed.

If the selected page has an event handler for this event, this particular event will not be raised since it will be assumed that the associated page's event handler executed the appropriate code.

See Also

• WizardPage

public event WizardButtonEventHandler ButtonMouseEnter

Event Type

WizardButtonEventHandler

See Also

• WizardPage

public event WizardButtonEventHandler ButtonMouseLeave

Event Type

WizardButtonEventHandler

See Also

• WizardPage

public event EventHandler CancelButtonClick

Event Type

EventHandler

Remarks

Handlers of this event generally abort any currently-executing processing tasks and close the Form containing the Wizard control.

If the selected page has an event handler for this event, this particular event will not be raised since it will be assumed that the associated page's event handler executed the appropriate code.

See Also

• WizardPage

public event EventHandler FinishButtonClick

Event Type

EventHandler

Remarks

Handlers of this event generally finish processing any remaining wizard tasks.

If the selected page has an event handler for this event, this particular event will not be raised since it will be assumed that the associated page's event handler executed the appropriate code.

See Also

• WizardPage

public event EventHandler HelpButtonClick

Event Type

EventHandler

Remarks

Handlers of this event generally display help for the currently displayed wizard step.

If the selected page has an event handler for this event, this particular event will not be raised since it will be assumed that the associated page's event handler executed the appropriate code.

See Also

• WizardPage

public event WizardLayoutButtonsEventHandler LayoutButtons

Event Type

WizardLayoutButtonsEventHandler

See Also

• WizardPage

public event WizardPageCancelEventHandler NextButtonClick

Event Type

WizardPageCancelEventHandler

Remarks

By default, the Wizard will move to the next WizardPage in the WizardPageCollection after this event fires. To cancel this behavior, set the Cancel property of the event argument to true. Then you can use the SelectedPage property to set the WizardPage that should be displayed.

If the selected page has an event handler for this event, this particular event will not be raised since it will be assumed that the associated page's event handler executed the appropriate code.

See Also

• WizardPage

public event EventHandler SelectionChanged

Event Type

EventHandler

Remarks

Use this event to perform any processing that should occur after the selected page changes.

See Also

• WizardPage

public event WizardPageCancelEventHandler SelectionChanging

Event Type

WizardPageCancelEventHandler

Remarks

Use this event to perform any processing that should occur before selected page changes. The Page property of the event arguments indicates the WizardPage about to be selected. The selection change may be cancelled by setting the Cancel property of the event arguments to true.

See Also

• WizardPage