The following settings can be found under Settings->Special Engines->PBEngine:
-
Consider enabled status of parent window
If the value of this setting is Yes, an input on enabled controls is not possible in a disabled main window until the modal window is closed. This setting is not overwritten by the steering property InputOnDisabled=true (see chapter "Parameter Steering")
Default setting: No
-
DataWindow groups support
This setting must be True in order for groups of a DataWindow to be found by Tosca Wizard.
Default setting: False
-
DataWindow multi line table header support
If the value of this setting is True, DataWindows that have multiline headers can be scanned. Multiline column headers are combined to single-line headers upon scanning with Tosca Wizard (see chapter "Multiline headers").
-
Delay between item changes in DWComboBoxes
This setting specifies the waiting time in milliseconds when switching to the next DWCombobox item. By increasing this value you can ensure that the time for DropDownDataWindow is sufficient to specify the new value.
Default value: 600
-
Delay between two consecutive scroll commands
This setting specifies the wait time in milliseconds between two consecutive scroll commands.
Default value: 0
-
Enable DataWindow web properties
If this setting is set to False, the properties data.xhtml and data.xmlweb of the DataWindow of the Tosca Powerbuilder Engine are not requested and are neither available in Tosca Wizard nor to TestSteps. PowerBuilder does not write any additional files to the installation directory of the application without querying these properties.
If this setting is set to True, the properties data.xhtml and data.xmlweb are requested and are available in Tosca Wizard and in TestSteps. When these properties are searched in a query, PowerBuilder creates additional files in the installation directory of the application upon execution and scanning, which can be deleted once the execution has finished.
Default value: False
-
Possible captions of DataWindow exceptions
This setting allows DataWindow exception windows to be identified which have an individual window title. After this window has been identified, it is closed by clicking the OK button.
It is also possible to specify several values, separated by a semicolon.
Default value: DataWindow;
-
Prefix of the Win32 classname of datawindows
This setting specifies the prefix of the Win32 classname of DataWindows.
Default value: pbdw
-
If this setting is enabled, headers are assigned via their coordinates on the screen to the corresponding columns in a DataWindow.
Default setting: false
-
This setting enables a verification of the value that is stored in a database (raw value), in a DataWindow. In this case, the verification is performed with the syntax: .rawvalue=<Value>
Default setting: false
-
When enabling controls within DataWindows, PowerBuilder generates independent steerable Win32 controls, which are child controls of the DataWindow. If this setting is enabled, these specific child controls of the DataWindow are used to steer PowerBuilder applications.
Default setting: true
-
Wait for control creation
If this setting is enabled, the Engine waits until the control is available on the screen before a PBEditBox is steered. The setting "Use on demand controls" must have the value True.
Default setting: False
There are several ways to steer ComboBoxes in Powerbuilder DataWindows. The steering type to be used depends on the ComboBox to be steered.
ComboBoxes can be steered via the name of the entry to be selected.
A ComboBox entry can be selected via its index. For this purpose, the setting UseIndexSteering must be set to true. If the index is greater than 9, only one digit after the other is sent to the application. The setting IndexSteeringDelay specifies the time between the individual digit transfers.
OCR (Optical Character Recognition) can be used to select the required entry from a ComboBox. If the value of the setting UseOCRSteering is true, the Tosca Powerbuilder Engine tries to identify the correct ComboBox entry by converting graphical representations into text. The setting OCREntryHeight specifies the height of the entry and the setting OCREntryEndSpace specifies the number of pixels after the last ComboBox entry.
-
This setting specifies the waiting time between inputs. The value is specified in miliseconds.
Default value: 100
-
OCREntryEndSpace
Specifies the number of pixels that are empty after the last entry, i.e. are thus not used.
Default value: 10
-
OCREntryHeight
Specifies the pixel height of a ComboBox entry.
Default value: 21
-
If this setting is enabled, the elements in the ComboBox are steered according to their specified index.
Default value: false
-
If this setting is enabled, the Optical Character Recognition (OCR) is used for steering DWComboBoxes.
The "WIN32 I OCR components" can be used to specify additional settings for steering.
Default value: false
-
Spaces or the distance between several tabs can be specified here in order to optimize the optical character recognition (see setting "UseOCRTabRecognition"). All natural numbers including 0 are possible.
Default value: 3
-
If this setting is enabled, the optical character recognition (OCR) is used to steer a tab. Please make sure that the tabs are not covered by another window during the OCR and that they are positioned on the top border of the TabControl.
The "WIN32 I OCR components" can be used to specify additional settings for steering.
-
Scroll control visibility
When tabs are steered it can happen that there is not enough space for all the tabs on the screen so that they get moved to the area that is not visible. If this is the case, the Powerbuilder application provides a control for scrolling horizontally. The following values are possible:
Automatic: The number of available tabs is calculated and it is thus established whether a scroll control is available.
True: It is assumed that a scroll control is available.
False: It is assumed that there is no scroll control available.
-
This setting specifies the position of a scroll control on the screen. The following values are available: BottomRight, TopRight, LeftBottom and RightBottom (see table "POWERBUILDER I PBTabControl").
ToolBar
-
Path to hook
This setting contains the path to the DLL file that is responsible for PBToolBarControl steering. In addition, a C:\Temp directory is required, for which the user has write access. If C:\Temp does not exist, the directory must be created.
-
This setting contains the path to the directory where the image files of the tooltips of the steered controls are stored when steering the PBToolbarControl (see chapter "POWERBUILDER I PBToolBarControl").
-
Vertical probing distance
This setting specifies the vertical distance of the mouse pointer in the toolbar, to be able to scan the tooltips of the controls.
If this value is too small, some objects of the toolbar might be scanned more than once.
If the value is too high, some objects of the toolbar might be skipped and will thus not be scanned.
Default value: 15