Eingabe

<< Click to Display Table of Contents >>

Navigation:  Steuerelemente > Standard Steuerelemente >

Eingabe

Ein einzeiliges Eingabefeld, das dem Benutzer einen Text mit beliebiger Schriftart anzeigt und ihm erlaubt, selbst Eingaben zu tätigen. Der Text aus dem Eingabefeld kann markiert, kopiert und eingefügt werden. Durch die Möglichkeit, eine maximale Anzahl an Zeichen festzulegen, kann die Benutzereingabe beeinflusst werden. Bei Verwendung des Lesemodus hat der Benutzer keine Möglichkeit, den Text zu bearbeiten oder zu löschen. Das Steuerelement kann unsichtbar oder deaktiviert werden, sodass ein Anklicken nicht mehr möglich ist. Außerdem unterstützt es das Empfangen und Senden von Signalen bei verschiedenen Events.

 

Steuerelement auf der Parametermaske

Steuerelement zur Laufzeit

eingabe_zoom50

runtime4_zoom50

 

Eigenschaft

Erläuterung der Einstellungsoptionen

Steuerelemente mit dieser Eigenschaft

PARAMETER

Assoziiert den vordefinierten SQL- oder DSR-Parameter der DataNAUT-Applikation, der den Rückgabewert empfangen soll.

 

Je nach Komponente können auch mehrere selektierte Werte in einem Parameter zurückgegeben werden, dabei sind diese durch einen Delimiter getrennt. Zusätzlich kann hier optional ein Suffix und ein Prefix definiert werden. Der RawMode bestimmt, ob ein Parameter einzeilig oder mehrzeilig zurück gegeben wird.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

Anchors

Definiert, welche der vier Ränder der Komponente (links, oben, rechts, unten) verankert werden sollen.

 

Je nach Einstellung kann die Komponente beim Vergrößern des Fensters in eine bestimmte Richtung mitziehen und der Abstand zum Rand bleibt gleich. Sind mehrere Anker gesetzt, wird die Komponente dementsprechend gestreckt.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

AutoFill

Fügt automatisch und intelligent Füllzeichen zur Vervollständigung ein, wenn diese in der PictureMask festgelegt sind.

Eingabe

CharCase

Auswahl, ob der vom Benutzer eingegebene Text übernommen, in Groß- oder in Kleinbuchstaben umgewandelt werden soll. Der Text wird bereits bei der Eingabe entsprechend formatiert.

Combo, DB-Combo, DB-Lookup, Eingabe

ClearOnCopy

Bei aktiviertem Loop-Modus wird der Datenwert der Komponente nach dem Speichern von Daten gelöscht bzw. auf den Anfangswert zurückgesetzt (z.B. nach Klick auf "Weiter")

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Sprachkit

Color

Beliebige Farbe der Komponente ($+Farbcode)

Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, Eingabe, Liste, Memo

DataQuery

Defniert eine frei gestaltbare SQL-Datenabfrage zur Anzeige von Daten. Die Datenmenge kann auf Änderungen von Parametern in anderen Steuerelementen reagieren.

 

Je nach Steuerelement muss die Abfrage die in DataCaptionField und DataValueField hinterlegten Datenfelder als Attribute enthalten; dies ist daran zu erkennen, dass die Eigenschaft im Steuerelement vorhanden ist.

 

Über das Signalsystem lassen sich Abhängigkeiten von Eingaben oder Auswahlen in anderen Steuerelementen steuern, um Änderungszustände von Daten in der Maske anzuzeigen.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

DataQuerySignalBehavior

Auswahl, unter welchen Umständen die SQL-Abfrage die Daten aus der Datenbank aktualisiert, wenn gleichzeitig ein treffendes Signal vorliegt.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

DataValueField

Definiert den Namen des Datenfeldes, welches den Datenwert im Steuerelement darstellt, wenn in DataQuery eine SQL-Datenabfrage zugewiesen wurde.

 

Der Rückgabewert der Datenmenge muss dem Datentype der Zielkomponente entsprechen oder sich dahin gehend konvertieren lassen.

 

Im Gegensatz dazu enthält DataCaptionField den Anzeigewert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Enabled

Aktiviert oder deaktiviert die Komponente für die Verwendung durch den Benutzer. Das Element wird dabei in den meisten Fällen farblich leicht ausschattiert. Auch wenn eine Komponente inaktiv ist, werden die Datenwerte an die Parametersteuerung zurück geliefert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Font

Bestimmt Farbe, Schriftart, Schriftschnitt und Schriftgröße des Textes im Steuerelement in einem eigenen Dialog.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Beschriftung (Label), Liste, Memo, Kalender, Radio, Sprachkit

Height

Höhe der Komponente in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Hint

Optionaler individueller Hilfetext, der angezeigt wird, wenn sich der Mauszeiger über der Komponente befindet.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image

KeyMapEnabled

Wenn aktiviert, können die in KeyMapTable hinterlegten Übersetzungsanweisungen zur Umwandlung von Tastencodes benutzt werden.

 

Mit dieser Einstellung können beispielweise Ausgabewerte fest programmierter Barcode-Scanner wie RETURN durch TAB überschrieben werden.

Eingabe

KeyMapTable

Eingabefeld für Zeichencodes, die automatisch ersetzt werden sollen, wenn das entsprechende Zeichen in der Eingabe des Benutzers vorkommt. Zugrunde liegt der ASCII-Zeichensatz in der jeweiligen Landescodierung.

 

Mehrere Mappings können mit Komma getrennt eingegeben werden.

 

 

Eingabe

Left

X-Position der Komponente auf dem Formular in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

MaxLength

Maximale Anzahl von Zeichen, die bei der Eingabe von Daten im Eingabefeld der Komponente zulässig sind.

Combo, DB-Combo, DB-Lookup, Eingabe, Sprachkit

Name

Beliebige eindeutige Bezeichnung der Komponente.

 

Die Bezeichnung wird zur Navigation im DataNAUT Designer verwendet. Zudem wird die Bezeichnung zur Laufzeit herangezogen, wenn eine Meldung zum Steuerelement angezeigt wird, beispielsweise weil der Benutzer keinen Eingabewert hinterlassen hat.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

PasswordChar

Bestimmt ein Zeichen, dass zum Verdecken der Eingabe dient, beispielsweise bei der Eingabe von Passwörtern. Der DEFAULT-Wert ist #0, demnach werden keine Eingaben verdeckt.

Eingabe

PictureMask

Maskiert eine Auswahl von Zeichen, die vom Benutzer eingegeben werden können. Außerdem kann angegeben werden, ob Buchstaben automatisch groß bzw. klein geschrieben werden, was die Dateneingabe für den Benutzer stark beschleunigt. Wird keine Maske angegeben, sind alle Eingaben erlaubt, die das Steuerelement unterstützt.

 

 

 

Eingabe

ReadOnly

Verhindert, dass der Benutzer Daten der Komponente verändern kann. Das Schreiben von Daten in ein Eingabefeld ist somit vollständig abgeschaltet. Verfügt das Steuerelement über eine zugewiesene DataQuery, können jedoch Daten angezeigt werden.

 

Durch Anzeige in einem oder mehreren ReadOnly-Datenfeldern lässt sich beispielsweise nach Eingabe einer Kundennummer prüfen, ob die Auswahl den korrekten Kunden getroffen hat, in dem in ReadOnyl-Feldern zur Kontrolle Namen und Adresse angezeigt werden.

Datum, DB-Checklist, DB-Combo, DB-Lookup, Eingabe, Grid, Memo

RegExp

Definiert einen Regulären Ausdruck, der die Eingabe des Benutzer in dem betreffenden Steuerelement prüfen oder ggf. modifizieren kann.

 

Die Art der Prüfung wird nach den in RegExpType durchgeführten Einstellungen definiert. Entspricht die Eingabe nicht den im Ausdruck definierten Regeln, greifen die in RegExpImmediate und RegExpTemplate hinterlegten Einstellungen und Regeln zusätzlich.

Combo, DB-Combo, DB-Lookup, Eingabe, Memo

RegExpImmediate

Definiert den Zeitpunkt der Prüfung auf den in RexExp hinterlegten Ausdruck für die Eingabe des Benutzers. Die Prüfung erfolgt nur, wenn die Auswertung in RegExpType aktiviert ist.

 

Bei Einstellung TRUE wird der Wert unmittelbar während der Eingabe und spätestens beim Verlassen des Steuerelements geprüft.

 

Bei Einstellung FALSE wird der Wert erst dann geprüft, wenn der Benutzer in der Maske die bestimmungsgemäße Aktion zum Ausführen der DataNAUT Applikation auswählt, also die Maske verlassen wird. Die Prüfung erfolgt nicht mehr, wenn die Maske vom Benutzer abgebrochen wird.

 

Entspricht die Eingabe nicht den Regeln des hinterlegten Ausdrucks, ist das Verlassen des Steuerelements oder der Maske einstellungsbedingt nur durch Abbruch der Maske möglich.

Eingabe

RegExpTemplate

Definiert ein Template mit einem Regulären Ausdruck.

Combo, DB-Combo, DB-Lookup, Eingabe, Memo

RegExpType

Definiert das Verhalten des Steuerelements bei Prüfung des in der Eigenschaft RegExp hinterlegten Regulären Ausdrucks.

Combo, DB-Combo, DB-Lookup, Eingabe, Memo

SignalOnEnter

Bestimmt, ob ein Signal auf den unter SignalSendChannels angegebenen Kanälen gesendet wird, wenn das betreffende Steuerelement den Fokus erhält, zum Beispiel in dem es angeklickt wird. Die Eigenschaft SignalSendEnabled muss dazu ebenfalls aktiv gesetzt sein.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalOnExit

Bestimmt, ob ein Signal auf den unter SignalSendChannels angegebenen Kanälen gesendet wird, wenn das betreffende Steuerelement den Fokus verliert. Die Eigenschaft SignalSendEnabled muss dazu ebenfalls aktiv gesetzt sein.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalReceiveChannels

Enthält eine durch Kommata separierte Liste von numerisch benannten Kanälen, auf denen das Steuerelement Signale empfängt, sofern die Eigenschaft SignalReceiveEnabled aktiv ist.

 

 

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Info-ProgressBar, Info-Shape

SignalReceiveEnabled

Schaltet das Empfangen von Signalen von anderen Steuerelemente auf den unter SignalSendChannels angegebenen Kanälen ein oder aus.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Info-ProgressBar, Info-Shape

SignalSendChannels

Enthält eine durch Kommata separierte Liste von numerisch benannten Kanälen, auf denen das Steuerelement Signale sendet, sofern die Eigenschaft SignalSendEnabled aktiv ist.

 

 

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

SignalSendEnabled

Schaltet das Senden von Signalen an andere Steuerelemente auf den unter SignalSendChannels angegebenen Kanälen ein oder aus.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar

TabOrder

Gibt die Position in der Reihenfolge an, in der das betreffende Steuerelement aktiviert werden soll und den Fokus erhält, wenn der Benutzer auf einem anderen Element die TAB-Taste drückt. Das Steuerelement mit der kleinsten Zahl wird zuerst aktiviert. Die Zählweise ist 0-basiert.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Sprachkit, Info-ProgressBar

Task

Bei Aktivierung dieser Option ist die Eingabe oder Auswahl von Daten in dem betreffenden Steuerelement für den Benutzer Pflicht. In Steuerelementen mit Mehrfachauswahl muss dann mindestens ein Datenobjekt gewählt werden.

 

Wird keine Eingabe oder Auswahl vorgenommen, wird eine entsprechende Fehlermeldung mit Verweis auf den unter Name angegebenen Namen der Komponente angezeigt. Das Verlassen des Steuerelements oder der Maske ist dann einstellungsbedingt nur durch Abbruch der Maske möglich.

ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, Eingabe, Grid, Liste, Memo

Text

Text, der bei der ersten Anzeige der Maske im Steuerelement angezeigt wird.

Combo, Eingabe, Sprachkit

Top

Y-Position der Komponente auf dem Formular in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

TrimText

Je nach Einstellung werden führende, folgende oder Leerzeichen an beide Seiten entfernt, bevor der Datenwert als PARAMETER an die Programmsteuerung übergeben wird.

Combo, Eingabe, Memo

Visible

Gibt an, ob die Komponente auf dem Formular für den Benutzer sichtbar ist oder nicht.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape

Width

Breite der Komponente in Pixel.

Button, ButtonEdit, Checkbox, CheckCombo, Checklist, Combo, Datum, DB-Checklist, DB-Combo, DB-Liste, DB-Lookup, DB-Radio, Eingabe, Grid, Beschriftung (Label), Liste, Memo, Kalender, Radio, Uhrzeit, Trackbar, Grafik/Image, Sprachkit, Info-ProgressBar, Info-Shape