¶ Beschreibung
ComboBox = Kombinationsfeld/Klappliste
Die ComboBox wird immer dann eingesetzt, wenn eine Auswahl erfolgen soll und im Formular nicht genügend Platz zur Verfügung steht.
ComboBoxen können mittels MASKITO FormDesigner über verschiedene Möglichkeiten mit Inhalt gefüllt werden.
- Feldliste
Die Liste wird durch Zeilenumbruch getrennt im Inhaltsfenster der ComboBox angelegt. - Wertliste
Die Liste wird über eine Zuweisung mit Inhalt gefüllt. - Auslesen aus einer Datenbank
Die Liste wird über eine Abfrage aus einer Datenbank geholt. Das heißt beim Laden des Formulars werden SQL-Befehle ausgeführt, welche die ComboBox mit Werten belegt. Mehr zum Befüllen von ComboBoxen aus der Datenbank finden Sie hier.
Die Auswahl des Inhalts erfolgt im Formular über das Aufklappen der Liste und dem Klick auf den betreffenden Eintrag. Seit Formularware 3.0 - SP I sind Comboboxen auch per Tastatureingabe editierbar. Dies gilt für Windows- und Web-Formulare.
Comboboxen werden im PDF-Ausdruck ausgegeben.
¶ Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
| Key | Schlüsselwerte für die Auswahlliste Lesen Sie optional mit dem Platzhaltersuffix .Key die ID der gewählten Option aus, um diese Eingabe des Anwenders an anderer Stelle weiterzuverwenden, z. B. Platzhalter [@cb_Land.Key]. |
| DropDownWidth | Ansichtsbreite der Liste in Pixel |
| Editierbar | Gibt an ob die Auswahl auch durch Tastatureingaben getroffen werden kann. Angabe: True (Ja) oder False (Nein) |
Für Windows-Formulare können Sie für konkrete Controls über den Befehl xmloutput in Funktionen flexibel zur Laufzeit steuern, ob die betreffenden Nutzereingaben bei der Speicherung des Datensatzes als sfx-Datei (XML) ausgegeben werden sollen (True) oder nicht (False). Alternativ legen Sie das gewünschte Verhalten fix standardmäßig über die Eigenschaft XMLoutput im Control-Eigenschaftenpanel im FormDesigners fest.
¶ Anwendungsbeispiele
Im folgenden werden Anwendungsszenarien aufgeführt, wie sie dieses Auswahlfeld verwenden können.
¶ ComboBox automatisch über Datenbank vorbelegen
In diesem Beispiel wollen wir ein Auswahlfeld automatisiert aus der Datenbank mit den zuletzt eingegebenen Einträgen befüllen. Dazu soll eine bearbeitbares Auswahlfeld verwendet werden, welches sich mit den letzten Einträgen der anderen Formulardatensätze beim Start des Web-Formulars automatisch befüllt.
- Per MASKITO FormDesigner im Formular die Eigenschaft
EditierbaraufTruesetzen → Die ComboBox kann mit eigenen neuen Einträgen erweitert werden. - Eigenschaft
MetaInfoaufTruesetzen → Dadurch wird die Spalte wird in der Datenbanktabelle sichtbar - Jeder hinterlegte Eintrag soll nur einmal in der Auswahl erscheinen.
- Erstelle eine Datenbankverbindung mit folgenden Einstellungen:
Hinweis:
Mit der Datenbankverbindung und der Schreibweise[@@DB_FW_SERVER]im Feld Servername wird jeweils der aktuelle MASKITO FormServer ausgewählt.
- Starte beim Laden des Formulars folgende Funktion:
- Erstelle eine globale
OnLoading-Funktion bzw. füge einer vorhandenen OnLoading-Funktion folgenden Eintrag hinzu:
Der SQL-String kann passend erweitert werden.
Wenn nur die 5 häufigsten Werte in der Liste ausgegeben werden sollen, welche nach Häufigkeit absteigend sortiert werden sollen, dann würde der Wert in der Funktion folgendermaßen aussehen:
[%con1:2:Select top 5 cb_1 from _FormData[?form_id] group by cb_1 order by COUNT(cb_1) desc %]
Somit steht nun ein Auswahlfeld cb_1 zur Verfügung, welches dem Anwender die zuletzt verwendeten Einträge zur Schnellauswahl bereitstellt.