f$SetzeTextProp (f$SetTextProp)

Mit dieser Funktion können alle Dialogfeld-Eigenschaften gesetzt werden, die über einen Text verfügen. Voraussetzung für diese Funktion ist, dass der betreffende Dialog mit f$DialogOeffnen geöffnet wurde.

Hinweis: Dies ist eine Expertenfunktion, die für anspruchsvolle Anwendungen gedacht ist. Für Normalfälle sollte die Funktion f$Dialog verwendet werden.

Diese Funktion kann sowohl eingesetzt werden, um einen einzelnen Dialog für mehrere Anwendungsfälle oder Fallunterscheidungen einzusetzen (statisch), oder aber dynamisch innerhalb einer Überprüfungslogik (Kontroll ET), um direkt auf Werteänderungen im Dialog zu reagieren.

Das zu verändernde Dialogelement wird über einen Namen identifiziert, der am Dialogobjekt im Dialogeditor hinterlegt wird (siehe dazu die Benennung von Dialogobjekten).

Hinweis: Der Name Dialog ist reserviert für Veränderungen des Dialogs.

Hinweis: Nicht jede Eigenschaft kann für jedes Dialogelement gesetzt werden, insbesondere können die Werte der Eingabefelder nicht über die Beschriftung gesetzt werden. Dies geschieht über die dem Dialogobjekt zugeordneten Parameter. Eine Übersicht über die verfügbaren Eigenschaften eines Dialogobjektes findet sich unter Allgemeine Eigenschaften einzelner Dialogobjekte.

Bitte beachten:

Wenn versucht wird, eine nicht verfügbare Eigenschaft für ein Dialogfeld zu setzen, wird keine Fehlermeldung ausgegeben, sondern der Befehl ignoriert.

Syntax:	f$SetzeTextProp( FensterID, ElemName, Eigenschaft, Wert )
	Argument	Typ	Bedeutung
	FensterID	Ganzzahl	die von f$DialogOeffnen zurückgegebene Fensteridentifikation
	ElemName	Zeichenkette	Name des Dialogelementes, das geändert werden soll
	Eigenschaft	Zeichenkette	zu setzende Eigenschaft (Groß/Kleinschrift beliebig): 'Beschriftung' / 'Caption': der dem Dialogfeld zugeordnete Text, z.B. die Beschriftung einer Schaltfläche
	Wert	Zeichenkette	der zu setzende Text
Beispiel:	Ändern der Beschriftung einer Schaltfläche: f$SetzeTextProp( FensterID, 'Projekttyp', 'Beschriftung', 'Angebot' ) Ein zusammenhängendes Beispiel ist bei der Beschreibung der Änderung eines Dialogs zur Laufzeit zu finden.

Siehe weiter (insbesondere auch zusammenhängende Beispiele):

Allgemeine Eigenschaften einzelner Dialogobjekte

Benennung von Dialogobjekten

Beispiel: Aktivieren von zusätzlichen Eingabefeldern

Ansteuerung von Dialogen und Dialogfeldern

Ändern eines Dialogs zur Laufzeit

Arbeiten mit mehreren gleichzeitig geöffneten Dialogen

Verwandte Funktionen:

f$SetzeSprache(f$SetLanguage)	Setzen weiterer Dialogfeld-Eigenschaften
f$SetzeNumProp (f$SetNumProp)	Setzen weiterer Dialogfeld-Eigenschaften
f$DialogOeffnen (f$DialogOpen)	Öffnen eines Dialogs mit Rückgabe ID
f$DialogStarten (f$DialogExecute)	Aktivieren eines Dialoges über ID
f$DialogBeenden (f$DialogClose)	Schließen eines Dialoges über ID