CX_WIDGET::SetValidationState
194050
Beschreibung:
Diese Methode gibt dem Entwickler die Möglichkeit, dem Nutzer Feedback zu seinen Eingaben zu geben. Sollte der Benutzer ungültige Werte eingeben, dann kann hiermit das fehlerhafte Eingabefeld markiert und eine Erklärung des Fehlers hinterlegt werden.
Der Validierungszustand besteht aus einem Level (ERROR, WARN, INFO), welches die farbliche Kennzeichnung des Widgets vorgibt und einem beschreibenden Text, der als Tooltip über dem Widget angezeigt wird. Wird ein Validierungszustand gesetzt, dann wird dadurch ein vorher gesetzter Validierungszustand des Widgets überschrieben.
Der Validierungszustand eines Widgets wird entweder durch ein ClearWindow des enthaltenden Fensters, oder durch ein ClearValidationState auf dem Widget oder einem Parent-Widget wieder gelöscht.
Code-Beispiel:
Widget(,StringWin) Call(ClearValidationState) GetValue(,Str) Cardinality case 0: ERROR T("String darf nicht leer sein", "String must not be empty") 1: WARN T("String hat nur 1 Zeichen", "String has only one character") default: INFO T("Alles OK", "Everything OK") endCase Widget(,Str) Call(SetValidationState)
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_WIDGET | Das Eingabefeld |
Top-1 | MULTIPLE_STRING | Der anzuzeigende Validierungstext | |
Top-2 | NOTIFICATION_LEVEL | Das Level der Validierungsnachricht | |
Stack(Out) | Top | - | - |