Dialogobjekt Alternativschalter

Der Alternativschalter, auch Optionsfeld genannt, dient zur Auswahl einer Alternative aus einer (festen) Liste. Das Dialogobjekt beinhaltet einen (vertieften) 3D-Rahmen mit einer optionalen Überschrift und die einzelnen darin enthaltenen Alternativschalter, die aus einem Text und dem „Schalterknopf" bestehen.

Innerhalb der Entscheidungstabelle wird der Alternativschalter durch einen einzelnen Parameter vom Typ Ganzzahl oder Zeichenkette abgebildet. Der Wert des Schalters entspricht der laufenden Nummer der Alternative im Rahmen (Ganzzahl-Parameter), bzw. dem dem Schalter zugeordneten Text (Zeichenketten-Parameter).

Wenn der Alternativschalter nicht eingestellt ist (alle Knöpfe leer sind), erhält der Parameter den Zustand LEER (Zeichenkette), bzw. den Wert –1 (Ganzzahl).

Der gesamte Alternativschalter (der Rahmen) wird markiert, in dem in die Fläche hinein geklickt wird, der einzelne Schalter wird durch Anklicken des Textes markiert.

Ein neuer Einzelschalter wird über die Schaltfläche „Neue Alternative" angelegt. Die Reihenfolge des Anlegens bestimmt auch die laufende Nummer, die im Fall eines Ganzzahl-Parameters übergeben wird. Diese Reihenfolge ist nachträglich änderbar. Der einzelne Schaltknopf kann nicht aus dem Rahmen heraus gezogen werden.

Ein Alternativschalter besitzt neben den allgemeinen Eigenschaften Allgemeine Eigenschaften der Dialogelemente folgende Eigenschaften:

Darzust. Text	Überschrift im Rahmen, welche die Auswahl erläutern soll. Der Text kann auch weggelassen werden. Über die Schaltfläche mit den 3 Punkten kann der darzustellende Text für jede Sprache des Dialogs erfasst werden.
Parameter	Parametername des Parameters, der dem Alternativschalter zugeordnet ist (siehe oben). Hat dieser Parameter bei der Ausführung vor Aufruf des Dialoges einen Wert >0 (Ganzzahl), bzw. einen Text-Wert (Zeichenkette), so wird die entsprechende Alternative aktiviert. Ansonsten bleibt die Auswahl leer. In der Werteliste ist als zusätzliche Sprache die Sprache „CODE" enthalten. Der Wert dieser Spalte wird auf den Parameter geschrieben, um eine sprachenabhängige Belegung des Parameters zu erreichen. Der Parametername kann im Eingabeassistenten ausgewählt und mittels Drag & Drop in dieses Feld gezogen werden.
Parameter (sichtbarer Text)	Name des Parameters, auf den der sichtbare Text geschrieben wird. Dieser Parameter muss nicht angegeben werden.
Neue Alternative	Es wird ein neuer Einzelschalter angelegt. Dieser erhält eigene Eigenschaften (siehe unten).
Veränderbar	Hier kann festgelegt werden, ob der Alternativschalter zur Laufzeit geändert werden darf. Dies ist eine Voreinstellung, die zur Laufzeit mit der Funktion f$SetzeBoolProp geändert werden kann.
Überprüfung	Durch Anschalten der Überprüfung kann während der Ausführung dieses Dialoges direkt auf Wertänderungen bei Verlassen dieses Feldes reagiert werden. Dies kann zur Fehlerprüfung der Benutzereingaben wie auch zum Setzen von Vorschlagswerten für andere Dialogfelder genutzt werden.

Dem Alternativschalter muss unbedingt ein Parameter zugeordnet werden. Ansonsten erscheint beim Speichern des Dialogs eine Fehlermeldung.

Ein Alternativschalter (Einzelschalter) besitzt folgende Eigenschaften:

Darzust. Text	Beschreibung der Alternative. Über die Schaltfläche mit den 3 Punkten kann der darzustellende Text für jede Sprache des Dialogs erfasst werden. Wie auch Listfeldern und Kombinationsfeldern wird als zusätzliche Sprache „CODE" erfasst.
Reihenfolge	Festlegung der Reihenfolge der einzelnen Alternativen.
Tiptext	Mehrsprachiges zuordnen eines Tiptextes.