Switch

Syntax

Switch expression

Description

This command initiates a Switch method construct. You use a Switch statement to select a course of action from a set of options based on the value of a variable, expression or calculation. It is similar to an If–Else If construct although the performance of a Switch construct tends to be faster.

The first line of the construction contains the Switch command. This defines the variable, expression or calculation on which the choice of action will depend. Following the Switch command, the Case commands provide values which, if matched with the expression supplied in the Switch line, cause the methods between case lines to be executed.

You can nest multiple Switch statements, and embed other conditional statements such as If–Else constructs.

Example

# next button - only allow user to proceed to next page of a paged pane if the required information has been entered

Calculate lPage as $cwind.$objs.PagedPane.$currentpage

Switch lPage
  Case 1
    If len(iSerialNumber)=0
      Calculate lErrorMsg as 'Please enter a serial number'
    End If
  Case 2
    If len(iUserName)=0
      Calculate lErrorMsg as 'Please enter your username'
    End If
  Case 3
    If iAgreeFlag=kFalse
      Calculate lErrorMsg as 'You may not proceed until you agree to the license agreement'
    End If
End Switch

If len(lErrorMsg)
  OK message {[lErrorMsg]}
Else
  Do $cwind.$objs.PagedPane.$currentpage.$assign(lPage+1) ## go to next page
End If