f$GetNumProp (f$LiesNumProp)
f$GetNumProp (f$LiesNumProp)
Properties that are present as numbers can be read with this function for specified dialog objects. A requirement for this function is that the dialog concerned was opened with f$DialogOpen.
Note: this is an expert function intended for demanding usage scenarios. In normal cases the f$Dialog function should be used.
The dialog element to be read is identified through a name given to the dialog object in the Dialog Editor (see Naming dialog objects)
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 an unavailable property for a dialog field, an error message is not produced and the command is ignored.
Syntax: | Value = f$GetNumProp( WindowID, ObjName, Property ) | ||
| 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 |
| Property | String | Property to be read (upper/lower case as desired): 'Width' / 'Breite' gets the width of the dialog 'Height' / 'Hoehe' gets the height of the dialog |
Result: | Integer | The retrieved value | |
Example: | ActTab = f$GetNumProp( WindowID, 'Tabstrip', 'Select' ) | ||