f$SetBoolProp (f$SetzeBoolProp)

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 can be set 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:	f$SetBoolProp( 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): 'visible' / 'sichtbar': the dialog field becomes visible (value=1) or invisible (value=0) 'enabled' / 'aktiv': the dialog field does accept entries (value=1) or not (value=0) 'Focus' / 'Fokus': the insertion point is positioned on this element (only value=1 is permitted)
	Value	Integer / logical	1 (=yes) or 0 (=no)
Result:	-
Example:	Activate a button: f$SetBoolProp( WindowID, 'Options', 'Enabled', 1 )

Related functions:

f$SetTextProp	Set further dialog field properties
f$SetNumProp	Set further dialog field properties
f$DialogOpen	Open a dialog with return ID
f$DialogExecute	Activate a dialog via ID
f$DialogClose	Close a dialog via ID