Branching [Switch]

More useful than simple skipping is to present the user with a set of choices, and to branch the flow accordingly. The WizardEngine provides a method named, "Switch" for this purpose. The parameters to "Switch" are:

•      Labels: An array of labels for the radio buttons.

•      Bmps: An array of bitmap values for the icons (32*32 bitmaps).

•      Descriptions: An array of descriptions (up to four lines of text can be accommodated).

•      Destinations: An array of state names.

•      DefaultVal: An optional parameter that is the value (0..2) of the initial selection.

A maximum of three choices can be accommodated:

SelectTask [
    WTitle = "Select Required Task"; 
    Task = Engine\Switch(Tasks, Bmps, TaskDescs, TaskSwitch); 
    IfMove; 
    [ 
          Move = 0; 
          ForceState(NextState); 
    ] 
]

The dialog below provides an example.

"Switch" returns the value (0..2) selected.