New Attributes
The following classes have new attributes:
• EntryField Class
• FrameExec Class
• Object Class
• SessionObject Class
For more information about these attributes, see the latest version of the Language Reference Guide.
EntryField Class ExitBehavior Attribute
The ExitBehavior attribute controls the action of the Tab key or Return key in an EntryField object. This attribute is ignored if the IsMultiLine attribute is set to FALSE.
FrameExec Class NextTargetField Attribute
The NextTargetField attribute is used to substitute for the TargetField attribute of FrameExec in cases when the user action is going to set the input focus to a field that is not yet present on the frame. The NextTargetField attribute is set only if the TargetField attribute is set to NULL.
The TargetField attribute can be set to NULL when:
1. The user clicks on an append row of a TableField.
2. The user action will scroll the TableField.
It is not mapped since the Exit event has not completed and the 4GL code might still do a "Resume" which would prevent it from completing. NextTargetField is set in this case. Not all of its attributes are reliable, and the 4GL code should not try to set any attributes of the field. However, attributes which never vary for the TableField column will be reliable.
The NextTargetField attribute can be used to confirm that the target is in a TableField and to determine which column of the TableField is the target.
Object Class Attributes
The Object class has the following new attributes:
• InstanceIdentifier
• InstanceReferences
InstanceIdentifier Attribute
The InstanceIdentifier attribute contains a value that uniquely identifies this instance of an allocated object. The value is guaranteed to be unique among the set of instantiated objects for an OpenROAD session. It is valid only during the life of this object. When this object is freed, the value is available for reuse.
InstanceReferences Attribute
The InstanceReferences attribute contains the current number of references to this instantiated object. A value of zero represents a permanent object that cannot be freed.
SessionObject Class
The SessionObject class has the following new attributes:
• ProcessWait
• ProcessWindow
ProcessWait Attribute
The ProcessWait attribute is used to specify whether commands executed by the "call system" statement block the execution of the currently running OpenROAD application until they complete. The default value is TRUE, indicating that the OpenROAD application will wait while executing statements via the "call system" statement. A value of FALSE will allow an OpenROAD application to continue executing 4GL statements after issuing a system command via the "call system" statement.
ProcessWindow Attribute
The ProcessWindow attribute is used to specify whether commands executed by the "call system" statement run in a process that has a window. The default value is TRUE, indicating that executing statements via the "call system" statement will create windows. A value of FALSE indicates that system commands run via the "call system" statement will not have process windows.
Last modified date: 12/20/2023