DBLookup

Hoch  Zurück  Vor

DBLookup ist quasi die erweiterte Variante von DBCombo: Das Lookup verwendet keine ausklappbare Liste, sondern ein extra Fenster zum Anzeigen der auswählbaren Daten. Dieses wird über einen Button neben dem Eingabefeld des Steuerelements geöffnet und entspricht im Wesentlichen einer Mini-Datenansicht. Dadurch ist es möglich, mehr als den Inhalt nur einer Spalte für die Auswahl anzuzeigen. Die Liste der Auswahlmöglichkeiten muss über ein extra Parameter-Query für den zugewiesenen Parameter erfolgen. Es gibt für DBLookup nicht die Möglichkeit, statische Vorgaben über die Eigenschaften des Steuerelements im Inspektor vorzugeben.

 

DBLookup_001DBLookup_002

 

DBLookup_003

 

Parameter - Der Parameter, der den Wert dieses Steuerelements zugewiesen bekommt. Der Wert, den der Parameter bekommt, wird über die Eigenschaften LookupValueField und LookupCaptionField definiert. Zusätzlich ist ein Parameter-Query für den entsprechenden Parameter nötig.

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.

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:

akLeft
akTop
akRight
akBottom
 

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.

Caption - Der vom Steuerelement angezeigte Text.

CharCase - Verhalten bezüglich Groß- und Kleinschreibung.

Mögliche Werte:

ecNormal - Groß- und Kleinbuchstaben sind möglich.
ecUpperCase - Die Eingabe wird automatisch nur in Großbuchstaben angezeigt.
ecLowerCase - Die Eingabe wird automatisch nur in Kleinbuchstaben angezeigt.
 

Color - Hintergrundfarbe des Steuerelements.

ExtendedDataView - Über diese Eigenschaft kann gesteuert werden, ob in der Datenansicht zur Wertauswahl für dieses Steuerelement die volle Funktionalität geboten werden soll oder nicht. Bei false wird eine einfache Ansicht verwendet, ohne Sortier- und Gruppierfunktionen, bei true die Erweiterte mit allen Funktionen. Die einfache Ansicht bietet den Vorteil, dass sie wesentlich schneller angezeigt werden kann.

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.

LookupCaptionField - Name der Spalte/des Feldes, aus dem die Anzeigewerte ausgelesen werden.

LookupFieldList - Liste der Felder, die in der Datenauswahl angezeigt werden sollen.

LookupValueField - Name der Spalte/des Feldes, aus dem die Rückgabewerte ausgelesen werden.

MaxLength - Maximal erlaubte Länge der Eingabe bzw. Auswahl in Zeichen.

ParameterQuery - Das ParameterQuery-Script, das für dieses Steuerelement verwendet werden soll.

RegExp - Regulärer Ausdruck, über den je nach gewähltem RegExpType die Benutzereingabe überprüft oder nachträglich verändert werden kann. Näheres siehe RegExpType.

RegExpTemplate - Text, durch den die Teile der Eingabe ersetzt werden sollen, die auf den regulären Ausdruck aus RegExp passen. Wird nur berücksichtigt, wenn RegExpType den Wert rtsSubsitute oder rtsReplace hat.

RegExpType - Legt fest, ob und wie der reguläre Ausdruck aus RegExp auf die Benutzereingabe angewendet werden soll. Folgende Werte sind möglich:

rtsOff - Der reguläre Ausdruck wird nicht angewendet.
rtsValidate - Die Eingabe wird mittels des regulären Ausdrucks auf Gültigkeit überprüft. Passt die Eingabe nicht auf den Ausdruck, dann wird dem Benutzer eine entsprechende Fehlermeldung angezeigt.
rtsSubstitute - Mittels des regulären Ausdrucks wird nach passenden Passagen in der Benutzereingabe gesucht, die dann durch den in RegExpTemplate angegebenen Text ersetzt werden.
 

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 von DBLookup bedeutet dies, dass ein Wert ausgewählt sein muss.

Top - Abstand zum oberen Fensterrand in Pixeln.

Width - Breite des Steuerelements in Pixeln.