f$GetTextProp (f$LiesTextProp)

Properties that are present as text 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 which is given to the dialog object in the Dialog Editor.

Note: not every property is available for each dialog element.

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:	Text = f$GetTextProp( WindowID, ObjName, Property )
	Argument	Type	Meaning
	WindowID	Integer	The window ID returned by f$DialogOpen
	ObjName	String	Name of the dialog element to be read
	Property	String	Property to be read (upper/lower case as desired): 'Caption' / 'Beschriftung': the caption for the active tab in a Tabstrip.
Result:	String	The value of the property read
Example:	ActTab = f$GetTextProp( WindowID, 'Tabstrip', 'Caption' ) → ActTab = 'General'