CallOptions Type for Smart Devices

Unofficial Content

CallOptions are used to specify at runtime the transitions, behavior and position in a call to a particular panel.
The type gives us control over how is affected the call stack when a call is made and also defines what happens to the execution of the event that makes the call to the panel.

By default the behavior is as follows:

The call panel appears, stays in the call stack and waits for it to return to continue the execution of the event.

Using "call type" we can call a panel as a Popup, call a panel contextually (callout). Or call it without including it in the stack.

To do this, we need to set the type property of the CallOptions object, whose values are defined in the enumerated domain called CallType.

Values:

Push
Replace
Popup
Callout

The syntax to change the default behavior at runtime is:

<object name>.CallOptions.Type = CallType.<call type name>

Detailed description of each CallType:

Push

This is the default behavior, the called panel appears in the same space as the caller and the caller waits for his return to continue execution.

Replace

The called panel replaces the caller in the call stack -this will save memory space. It means that when we call a panel using this call type, the call terminates execution of the event -a call of this type must be the last line of the caller event.

Popup

If the called panel has output parameters, its execution is modal (the caller event waits for its return to continue with the execution). 

The size of the popup can be changed with the following parameters from the CallOptions (these parameters only apply when the Type is Popup or Callout):

CallOptions.TargetSize = <Panel Size Type>

The values of PanelSizeType can be:

Default  (Platform Default)
Small 
Medium
Large

Or a custom size can be defined setting the values for Target Height and Width as follows:

CallOptions.TargetHeight = "dips or percentage of the parent height"
CallOptions.TargetWidth = "dips or percentage of the parent width"

NOTE: Target property does not apply when CallType = Popup.

Callout

The call can be canceled by touching on any item outside called panel interface. The call to the panel is not modal.
The Callout Type is not implemented in Android, it behaves like the Popup option in that platform.

The callout option when using iPhone is equivalent to a full-screen popup.