f$SetNumProp (f$SetzeNumProp)
f$SetNumProp (f$SetzeNumProp)
A range of dialog field properties, e.g. visibility of individual elements, can be changed dynamically with this function. A requirement for this function is that the dialog concerned was opened with f$DialogOpen. The f$SetBoolProp and f$SetNumProp functions are equal.
Note: this is an expert function intended for demanding usage scenarios. In normal cases the f$Dialog function should be used.
This function can be used to apply a single dialog for multiple applications or differences (statically) or also dynamically within a watching logic (Watch-DT) to respond directly to value changes in the dialog.
The dialog element to be modified is identified with a name which is given to the dialog object in the Dialog Editor.
Note: the name Dialog is reserved for changes in the dialog.
Note: not every property is available for each dialog element, e.g. a fixed text cannot be enabled.
Please note:
If you try to set a property that is not available for a dialog field, an error message is not produced and the command is ignored.
Syntax: | f$SetNumProp( WindowID, ObjName, Property, Value ) | ||
| Argument | Type | Meaning |
| WindowID | Integer | The window ID returned by f$DialogOpen |
| ObjName | String | Name of the dialog element to be changed or "Dialog" for the dialog's properties themselves |
| Property | String | Property to be set (upper/lower case as desired): 'Width' / 'Breite' sets the width of the dialog 'Height' / 'Hoehe' sets the height of the dialog 'Fullscreen' / 'Vollbild' sets the dialog to full-screen mode |
| Value | Integer | The value to be set |
Example: | f$SetNumProp( WindowID, 'Tabstrip', 'Select', 2 ) | ||