f$SetTextProp (f$SetzeTextProp)
f$SetTextProp (f$SetzeTextProp)
You can set all dialog field properties containing text with this function. 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.
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 can be set for every dialog element, input field values especially cannot be set via the caption. This occurs via the parameters assigned to the dialog object.
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: | f$SetTextProp( 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 |
| Property | String | Property to be set (upper/lower case as desired): |
| Value | String | The text to be set |
Example: | Change a button's caption: An example in context can be found with the description for changing a dialog for runtime. | ||