avSwitch Method

Method: avSwitch

Parameters:

Name Usage Class Description

To

Input - Mandatory

Alpha – max length 32

Specify as one of FRAMEWORK, APPLICATION or BUSINESSOBJECT indicating the object to which control is to be switched.

Named

Input – Optional

Alpha – max length 32

Specifies the User Object Name/Type of the APPLICATION or BUSINESSOBJECT that control is to switch to.

ToObjectNamed

 

Input - Mandatory

Alpha – max length 32

Specifies the User Object Name/Type of the APPLICATION or BUSINESSOBJECT that control is to switch to.

Special values

*SELECT_APPLICATION

*SELECT_BUSINESSOBJECT

*APPLICATION_ABOUT

*FRAMEWORK_ABOUT

may be used

Execute

Input – Optional

Alpha – max length 32

Specify the User Object Name/Type of any command that is to be executed in the target FRAMEWORK, APPLICATION or BUSINESSOBJECT.

ClearInstanceList

Input – Optional

Boolean

Clear the current business object instance list before adding new instances with the avAddSwictInstance method. Specify as TRUE or FALSE (in uppercase) only. Default value is FALSE.

NOTE: This parameter is only effective if new instances are added with the avAddSwictInstance method.

Caller

Input – Mandatory

PRIM_OBJT

Always specify this argument as Caller(#Com_Owner)), unless you are using VLF-ONE and find that Caller(#Com_Owner ) will not compile.

In that case use Com_Owner(#uSystem.MainVLFPanel).

CallerInfo

Input – Optional

Alpha – max length 20

VLF-WIN only. Use this optional argument to provide additional identification information. 

In VLF-ONE programs use CallerReference.

CallerReference

Input - Optional

PRIM_OBJT

 

A reference to any RDMLX object.

Optionally used with the Execute() parameters to pass details to the command handler's uExecute method. 

TargetWindow

 

Input – Optional

 

Alpha – max length 256

 

 

Specifies the target window in which the switch operation should be performed. Allowable values are CURRENT (the current window), MAIN (the main window) or specific window name. The default value is MAIN.

 

Examples:

Refer to shipped example command handler DF_DET17.