f$SetzeBoolProp (f$SetBoolProp)

Mit dieser Funktion kann eine Reihe von Dialogfeld-Eigenschaften wie z.B. die Sichtbarkeit einzelner Elemente dynamisch verändert werden. Voraussetzung für diese Funktion ist, dass der betreffende Dialog mit f$DialogOeffnen geöffnet wurde. Die Funktionenf$SetzeBoolProp und f$SetzeNumProp sind gleichwertig.

Hinweis: Dies ist eine Expertenfunktion, die für anspruchsvolle Anwendungen gedacht ist. Für Normalfälle sollte die Funktion f$Dialogf$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 DialogobjektenBenennung 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, z.B. kann ein Fixtext nicht aktiv gesetzt werden. 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$SetzeBoolProp( 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): 'sichtbar' / 'visible': das Dialogfeld wird sichtbar (Wert=1) oder unsichtbar (Wert=0) 'aktiv' / 'enabled': das Dialogfeld nimmt Eingaben entgegen (Wert=1) oder nicht (Wert=0) 'Fokus' / 'Focus': die Einfügemarke wird auf dieses Element positioniert (nur Wert=1 zulässig)
	Wert	Ganzzahl / Logisch	1 (=ja) oder 0 (=nein)
Ergebnis:	-
Beispiel:	Aktivieren einer Schaltfläche: f$SetzeBoolProp( FensterID, 'Optionen', 'Aktiv', 1 )

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$SetzeTextProp	Setzen weiterer Dialogfeld-Eigenschaften
f$SetzeNumProp	Setzen weiterer Dialogfeld-Eigenschaften
f$DialogOeffnen	Öffnen eines Dialogs mit Rückgabe ID
f$DialogStarten	Aktivieren eines Dialoges über ID
f$DialogBeenden	Schließen eines Dialoges über ID