MX-Frame Library Send comments on this topic.
Pages
See Also
MX-Developer > MxWizard > Pages

Glossary Item Box

Individual pages for the MxWizard component are managed with MxComponent Designer. With the designer pages can be added and removed. Properties are available which define the appearance and the behaviour of each page. It is also possible to define previous rules and next rules. Rules are executed before previous or next page is displayed. If the condition is satisfied previous or next page is displayed, otherwise not.

Desired business logic can also be implemented on each page. Business logic is implemented with workflows. A workflow can be attached to a page. For each workflow it is possible to define when it is triggered. It can be triggered on Previous or Next button click. Or it can be triggered at the moment wizard displays certain page.

Access MxComponent Designer

  1. Open previously created wizard from Solution Explorer.
  2. Open Properties window for the MxWizard component.
  3. Edit the Pages property in section Misc.

Desirable number of pages can be added. Created pages are displayed in run time in the same order as they are displayed in tree list in section Component Browser. Pages can be added to a wizard.

To Add a Page

  1. Open MxComponent Designer for the desired wizard.
  2. Right click Pages in Component Browser section and select Page.
  3. New page is added to the end of the list.
  4. Rearrange the order of pages by selecting and dragging the page on desired position in the tree list.

To Remove a Page

  1. Open MxComponent Designer for the desired wizard.
  2. Select the page you wish to delete in the tree list in section Component Browser.
  3. Press Delete key on the keyboard.

Page Properties

Each page can be customized by setting its properties. Page properties define the appearance and the behaviour of individual page.

Property Description
Description  Defines short description of the functionality implemented on the page. The description is visible in the header of the page.
Image  Defines an image that represents the page. The image is displayed in the header of the page.
Title  Defines the title of the page. Title is displayed at the top of the header on each page.
Enabled  If property is set to True, page will be visible in a wizard in runtime. Page will be visible according to the order defined in the tree list in design time. If property is set to False, page will not be visible. Page will be skipped.
Name  Defines the name of the page.

Rules

For each page rules can be defined. These rules define the behaviour of the wizard and individual page. Two types of rules exist, previous rule and next rule. Previous rule is evaluated when Back or Previous button is clicked on a page. If the rule is evaluated successfully previous page will be displayed. Next rule is evaluated when Next button is clicked on a page. If the rule is evaluated successfully next page will be displayed. If the page is the last in order the rule is evaluated on Finish button click. Both rules can be defined with Expression Designer which offers extensive possibilities with various variables and functions. The rule can be based on data which can change dynamically in runtime.

To access a rule

  1. Open the desired wizard in Solution Explorer.
  2. In property window edit Pages property
  3. In section Component Browser expand the desired page.
  4. Select Previous or Next rule node accordingly. 
  5. With the Expression Designer, displayed on the right part of the window, create a rule or a condition.

After a page is created, desirable controls can be attached to it. All standard Mx controls are available and can be used to define the user interface for the page. In order to have the desired page displayed in design time property PageIndex must have appropriate value.

See Also

©2009 Metronik. All Rights Reserved.