|
Checks the execution level in a task.
|
|
Syntax:
|
Level(generation)
|
|
Parameters:
|
generation: A number that represents the task's hierarchic position in the runtime task tree. 0 represents the current task, 1 its immediate ancestor, and so on.
|
|
Returns:
|
Alpha string containing:
CP_<control name> meaning Control Prefix
CS_<control name> meaning Control Suffix
CV_<control name> meaning Control Verification
GP_<variable name> meaning the depth of the Group Prefix
GS_<variable name> meaning the depth of the Group Suffix
HD_<event name> meaning a .NET event
HE_<expression> meaning a user-defined handler of a defined expression
HI_<internal event name> meaning a user-defined handler of an internal event
HR_<error name> meaning a user-defined handler of an error
HS_<key combination> meaning a user-defined handler of a system event
HT_<timer setting> meaning a user-defined handler of a defined timer
HU_<user event name> meaning a user-defined handler of a user-defined event
MP meaning Main Program
RM meaning Record Main (indicating the interactive level of the task)
RP meaning Record Prefix
RS meaning Record Suffix
SUBFORM - when executing the Level function within a subform task to inquire the level of the parent task: Level(1)
TP meaning Task Prefix
TS meaning Task Suffix
VC_<variable name> meaning Variable Change
FRAME - when executing the Level function within a program or task running in a frame to inquire the level of the parent task: Level(1)
|
|
Example:
|
Level(x) where x is 0, 1, and so on.
Level(1)'RP' is True if the current level in the parent task is Record Prefix.
IF(Level(1)=','Parent not found',') outputs the 'Parent not found' message if the current task has no parent.
|
|
Note:
|
ENDTASK: Level (1) <> 'RM' is used in synchronized one-to-many tasks.
|
|
See also:
|
TDepth
The Online and Rich Client Samples projects (program TF03 and RTF03)
|
