Skip to main content
Skip table of contents

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):
'Caption' / 'Beschriftung': the text assigned to the dialog field, e.g. a button's caption

 

Value

String

The text to be set

Example:

Change a button's caption:
f$SetTextProp( WindowID, 'Project type', 'Caption', 'Offer' )

An example in context can be found with the description for changing a dialog for runtime.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.