Checklist

Die Checklist zeigt eine Liste von Auswahlmöglichkeiten an, jeweils mit einem Kästchen zum Markieren/"Ankreuzen" des jeweiligen Eintrags. Durch Markieren der Kästchen können ein oder mehrere Werte ausgewählt werden, die dann als Wert für den gewählten Parameter zusammengesetzt werden.

Parameter - Der Parameter, der den Wert dieses Steuerelements zugewiesen bekommt. Der Wert, der dem Parameter zugewiesen wird, hängt von den Eigenschaften ResultLoadQuery bzw. ResultOption und Delimiter, Prefix und Suffix ab.

Keine zwei Steuerelemente dürfen den selben Parameter zugewiesen bekommen. Sollten doch zwei Elemente den selben Parameter zugewiesen bekommen, wird in den Statusinformationen der Punkt Parameter eindeutig rot markiert. Sollte einem Steuerelement, das die Eigenschaft Parameter besitzt, kein solcher zugeordnet sein, wird der Punkt Parameter zugewiesen rot markiert, um Sie darauf hinzuweisen. Im Kasten Liste der Steuerelemente können Sie die ungültigen Steuerelemente gezielt auswählen.

AllCheckedAtStartup - Ist dieser Wert true, sind alle Auswahlmöglichkeiten bei der Anzeige des Eingabefensters automatisch markiert. Bei false ist keine ausgewählt.

Anchors - Legt fest, wie sich das Steuerelement bei Größenänderungen des Eingabefensters verhält.

Die verankerten Ecken (Anchors) behalten beim Verkleinern oder Vergrößern des Fensters ihre absolute Position bezüglich der Fensterränder bei. Die Eigenschaft Anchors ist dabei eine Menge aus folgenden Werten, die festlegt, welche Seiten verankert sind:

In der Standardeinstellung [akLeft,akTop] behält das Steuerelement immer eine feste Position bezüglich der linken oberen Ecke des Fensters bei. Mit [akRight,akBottom] wäre die Position fix bezüglich der rechten, unteren Ecke. Bei beispielsweise [akLeft,akRight] bleibt der Abstand der linken bzw. rechten Seite des Steuerelements immer gleich zur linken bzw. rechten Seite des Fensters; das bedeutet, bei einer Verbreiterung des Fensters wird auch das Steuerelement breiter und bei einer Verkleinerung wird es ebenfalls kleiner. Durch passendes Setzen der Anchor-Werte bleibt das Layout des Eingabefensters auch bei Größenanpassungen durch den Benutzer erhalten.

AutoComplete - Hat die Checklist den Eingabefokus, dann wird durch Benutzereingabe der nächste passende Eintrag gewählt. Zum Beispiel wird durch Drücken der Taste A der erste Eintrag der Liste, der mit A beginnt ausgewählt (aber nicht "angekreuzt"). Weitere Eingaben in kurzem Zeitabstand verfeinern die Auswahl entsprechend.

Color - Hintergrundfarbe des Steuerelements.

Colums - Die Anzahl der Spalten, die zur Anzeige der Anzeigewerte verwendet wird.

Delimiter - Trennzeichen für die ausgewählten Werte.

Werden über die Checklist mehrere Werte ausgewählt, werden die entsprechenden Rückgabewerte zusammen, aber jeweils getrennt durch das Trennzeichen als Parameter-Wert verwendet. Sind zum Beispiel die Einträge A und B markiert und ist das Trennzeichen ein Komma, dann bekommt der dazugehörige Parameter den Wert A,B.

Font - Schriftart, -eigenschaften, -größe und -farbe, mit denen der Text des Steuerelements angezeigt wird.

Height - Höhe des Steuerelements in Pixeln.

Hint - Text, der als Tool-Tip / Hint angezeigt wird, wenn der Mauszeiger vom Benutzer für längere Zeit auf dem Steuerelement positioniert wird.

Left - Abstand zum linken Fensterrand in Pixeln.

Prefix - Wert, der dem Parameterwert vorangestellt wird.

Über Prefix und Suffix können Zeichenfolgen definiert werden, die immer dem Parameter-Wert vorangestellt bzw. angehängt werden. Beispielsweise wird durch das Prefix "(" und das Suffix ")" der Parameter-Wert in Klammern gesetzt. Prefix und Suffix sind vor allem für DSR-Parameter interessant, selten für normale SQL-Parameter.

RawMode - Hat diese Eigenschaft den Wert true, dann werden Prefix, Delimiter und Suffix nicht verwendet, um den Parameterwert zu erstellen. Bei mehreren ausgewählten Einträgen werden diese durch Zeilenumbrüche getrennt.

ResultLoadQuery - LoaderQuery, über das Anzeige- und Rückgabewerte für das Steuerelement definiert werden.

Um die Einträge des Steuerelements dynamisch auf Grundlage der Datenbank zu erzeugen, können Sie ein LoaderQuery einsetzen. Das LoaderQuery ist eine SQL-Abfrage, über deren Ergebnistabelle Anzeige- und Rückgabewerte definiert werden. Welche Felder bzw. Spalten der Tabelle für Anzeige und Rückgabe verwendet werden, hängt von den Werten für ResultLoadQueryCaption und ResultLoadQueryValue ab.

Siehe auch: Dynamische Auswahlmöglichkeiten per Loader-Query

ResultLoadQueryCaption - Name der Spalte, in der die Anzeigewerte stehen.

ResultLoadQueryValue - Name der Spalte, in der die Rückgabewerte stehen.

ResultOption - Dient der statischen Definition von Anzeige- und Rückgabewerten. Wird nicht verwendet, wenn ein ResultLoadQuery zugewiesen wurde.

Möchten Sie immer gleiche Auswahlmöglichkeiten für dieses Steuerelement bieten, unabhängig von der Datenbank, dann können Sie diese über diese Eigenschaft angeben. Es müssen Anzeigewerte und es können Rückgabewerte angegeben werden. Die Anzeigewerte sind die Werte, die dem Benutzer angezeigt werden. Die Rückgabewerte sind die Werte, die entsprechend der Auswahl des Benutzers dem gewählten Parameter zugewiesen werden. Es besteht die Möglichkeit, Anzeigewerte und Rückgabewerte als gleich zu definieren, den Index des ausgewählten Anzeigewertes als Rückgabewerte zu verwenden oder jedem Anzeigewert einen eigenen Rückgabewert zuzuweisen.

Siehe auch: Benutzerinteraktion über Parameter-Masken

Sorted - Legt fest, ob die Einträge des Steuerelements sortiert angezeigt werden (true) oder nicht (false).

Suffix - Wert, der dem Parameter-Wert angehängt wird. Details siehe Prefix.

TabOrder - Legt fest, in welcher Reihenfolge die Steuerelemente im Eingabefenster mittels der Tabulator-Taste durchgeschaltet werden können.

Beim Anzeigen des Eingabefensters bekommt das Steuerelement des Fensters den Eingabefokus, welches den niedrigsten TabOrder-Wert hat. Durch Drücken der Tabulator-Taste wird der Fokus dann auf das Element gewechselt, das den nächst größeren TabOrder-Wert hat. Elemente, die in einer logischen Reihenfolge stehen, sollten aufsteigende TabOrder-Werte zugewiesen bekommen. So kann der Benutzer bequem per Tastendruck durch diese hindurchschalten, ohne die Maus benutzen zu müssen und ohne, dass der Eingabefokus wild hin und her springt. Alle Steuerelemente, außer Text und Grafik, können den Eingabefokus bekommen.

Task - Definiert, ob es sich um eine Pflichteingabe handelt (true) oder ob eine leere Eingabe erlaubt ist (false).

Nur wenn für alle Steuerelemente, deren Eigenschaft Task den Wert true hat, eine Eingabe gemacht wurde, kann das Template ausgeführt werden. Im Fall der Checklist bedeutet dies, dass mindestens ein Eintrag in der Liste "angekreuzt" sein muss.

Top - Abstand zum oberen Fensterrand in Pixeln.

Width - Breite des Steuerelements in Pixeln.