Lade...
 

CX_WIDGET::SetValidationState

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.

 

Der Validierungszustand eines Widgets wird aktuell nur in der MorphIT-Oberfläche dargestellt. Nativ hat dies keine visuellen Auswirkungen.

 

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
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 - -
Funktionsaufruf: Call(SetValidationState)