DojoTimeTextBox

Mit dem Widget 'DojoTimeTextBox' wird ein Textfeld definiert, das einen Zeitwert enthält. Dieses Widget basiert auf der Definition für 'Dojo dijit.form.TimeTextBox'.

Wenn der Benutzer in das Widget klickt, wird ein Zeitauswahlmenü bereitgestellt, bei dem es sich um eine grafische Liste mit Zeitangaben handelt. Der Benutzer kann eine aufgelistete Zeit auswählen, um den im Feld angezeigten Wert zu aktualisieren.

Sie können das Zeitauswahlmenü anpassen, indem Sie die Eigenschaften visibleIncrement und visibleRange festlegen; und Sie können den im Zeittextfeld angezeigten Zeitwert anpassen, indem Sie die Eigenschaften value und timePattern festlegen.

Die unterstützten Eigenschaften für 'DojoTimeTextBox' sind nachfolgend aufgeführt:
constraints
Ein Wörterverzeichnis, das als Argument beim Aufrufen von Funktionen verwendet wird, mit denen die Benutzereingabe validiert wird. Diese Funktionen werden durch die Eigenschaft validators referenziert und als Validatorfunktionen bezeichnet.
Der Inhalt des Wörterverzeichnisses entspricht den jeweiligen Geschäftsanforderungen. Beispiel für eine Zuweisung:
constraints = new Dictionary{minimumHour = "11:30 AM"}};

In diesem Fall gibt eine Validatorfunktion möglicherweise eine Fehlernachricht zurück, falls der Benutzer einen Wert unter 11:30 AM für die Zeit angibt.

errorMessage
Die Nachricht, die angezeigt wird, wenn die Eingabe vorhanden, aber ungültig ist. Die Nachricht wird in einem bereitgestellten Ausgabefeld oder in einer bereitgestellten QuickInfo angezeigt.
inputRequired
Ein boolescher Wert, der angibt, ob eine Eingabe erforderlich ist. Die Fehlernachricht ist in diesem Fall der Wert der Eigenschaft inputRequiredMessage.

Diese Validierung wird vor allen anderen Validierungen durchgeführt, ist jedoch nur aktiv, wenn das Feld den Fokus erhält, nachdem es den Fokus zuvor verloren hat.

inputRequiredMessage
Eine Zeichenfolge, die angezeigt wird, wenn die Eigenschaft InputRequired den Wert 'true' aufweist, das Zeittextfeld keinen Inhalt aufweist und das Feld den Fokus erhält, nachdem es den Fokus zuvor verloren hat. Die Nachricht wird in einem bereitgestellten Ausgabefeld oder in einer bereitgestellten QuickInfo angezeigt.

Wenn die Eigenschaft inputRequiredMessage nicht vorhanden ist, besteht die Fehlernachricht aus der folgenden Zeichenfolge (je nach Ländereinstellung): "Dieser Wert ist erforderlich.".

placeholder
Eine Zeichenfolge, die im Zeittextfeld angezeigt wird, die jedoch entfernt wird, sobald der Benutzer in das Feld klickt. Die Zeichenfolge wird im Zeitfeld erneut angezeigt, sobald es leer ist und der Benutzer es nicht bearbeitet.
promptMessage
Eine Zeichenfolge, die den Benutzer zu einer Eingabe auffordert. Wenn das Zeittextfeld den Fokus erhält, wird die Zeichenfolge neben dem Feld in einer bereitgestellten QuickInfo so lange angezeigt, bis der Benutzer Inhalt hinzufügt oder ändert. Mit der Eigenschaft tooltipPosition können Sie die Zeichenfolgeposition zusätzlich definieren.
readOnly
Ein boolescher Wert, der angibt, ob das Zeittextfeld vor Benutzereingaben geschützt ist.
selectOnClick
Ein boolescher Wert, der angibt, welche Aktion ausgeführt wird, wenn der Benutzer von außerhalb des Zeittextfelds in das Feld klickt:
False (Standardwert)
Der Inhalt des Zeittextfelds wird nicht ausgewählt. Der Aktualisierungscursor wird an der Klickposition angezeigt.
True
Der Inhalt des Zeittextfelds wird ausgewählt. Jeder nachfolgende Mausklick zeigt den Aktualisierungscursor an der Klickposition an und der Inhalt des Zeittextfelds wird nicht mehr ausgewählt.
text
Eine Zeichenfolge, die dem verwendeten Standardformat entsprechend formatiert ist. Wenn Sie die Eigenschaft in der Widgetdeklaration festlegen, muss die Zeichenfolge der Einstellung für die Erstellungsdeskriptoroption defaultTimeFormat entsprechen. Wenn Sie die Eigenschaft zur Laufzeit festlegen, muss die Zeichenfolge der Einstellung für die Systemfunktion StrLib.defaultTimeFormat entsprechen, deren Standardwert der Wert der Erstellungsdeskriptoroption defaultTimeFormat ist.

Der Standardwert der Option defaultTimeFormat lautet HH:mm:ss.

timePattern
Eine Zeichenfolgekonstante, die angibt, wie die Zeit angezeigt werden soll:
TIMEBOX_FORMAT_12HR
Zeigt die Zeit im Format von 12:00 AM bis 11:59 AM und zwischen 12:00 PM und 11:59 PM an.
TIMEBOX_FORMAT_24HR
Zeigt die Zeit im 24-Stunden-Format an (Militärzeit).
validators
Ein Array mit Validatorfunktionen, die in der Reihenfolge der Array-Elemente aufgerufen werden. Wenn die Benutzereingabe die Validierung in einer bestimmten Funktion bestanden hat, gibt diese Funktion den Erfolg durch Rückgabe eines Nullwerts oder Leerwerts an; nur in diesem Fall wird die nächste Funktion im Array aufgerufen. Wenn die Benutzereingabe die Validierung nicht bestanden hat, gibt die Funktion das Fehlschlagen durch Rückgabe einer Zeichenfolge an, die nicht null oder leer ist.

Die Folge der Validatorfunktionen wird aufgerufen, wenn das Widget den Fokus verliert.

Wenn das Dojo-Zeittextfeld durch einen Controller referenziert wird, können Sie - unabhängig von den hier beschriebenen Funktionen - controllerspezifische Validatorfunktionen codieren. Die controllerspezifischen Funkionen werden nur aufgerufen, wenn die feldspezifische Validierung erfolgreich ist, und nur, nachdem das Widget den Fokus verliert.

Details zu Controllern finden Sie in 'Rich UI - Validierung und Formatierung'.

Jede der feldspezifischen Validatorfunktionen entspricht dem folgenden 'Delegate'-Abschnitt:
Delegate Validator(input String in, constraints dictionary in)
         returns(string?) end
input
Benutzereingabe.
constraints
Ein Wörterverzeichnis, das Informationen zur Erstellung eines regulären Ausdrucks oder zur Steuerung der Verarbeitung innerhalb der Validatorfunktionen bereitstellt. So kann das Wörterverzeichnis beispielsweise die Sicherheitsstufe des Benutzers angeben.
string?
Ein Nullwert oder ein Leerwert (falls kein Fehler auftrat) oder eine Zeichenfolge, die nicht null oder leer ist (falls ein Fehler auftrat).

Sie können von Ihrer Validatorfunktion aus eine oder mehrere der Funktionen aufrufen, die in der DojoLib-Bibliothek zur Verfügung stehen.

value
Eine Zeitvariable; eine automatische Konvertierung ermöglicht die Verwendung einer Zeichenfolge.
visibleIncrement
Die Schritte, in denen die Zeitangaben in der grafischen Liste im Zeitauswahlmenü angezeigt werden. Eine der folgenden Konstanten:
TIMEBOX_ONE_QUARTER (Standardwert zum Anzeigen von 15-Minuten-Schritten)
TIMEBOX_FIVE_MINUTES
TIMEBOX_HALF_HOUR
TIMEBOX_ONE_HOUR
TIMEBOX_TWO_HOURS
TIMEBOX_THREE_HOURS
TIMEBOX_FIVE_HOURS
TIMEBOX_TEN_HOURS
TIMEBOX_TWELVE_HOURS
TIMEBOX_FULL_DAY (zum Anzeigen von 24-Stunden-Schritten)
visibleRange
Die Zeitbereiche, die im Zeitauswahlmenü angezeigt werden sollen. Der Benutzer kann bei Bedarf zu weiteren Zeitangaben blättern. Die Konstanten entsprechen denen der Eigenschaft visibleIncrement.
Die folgenden Funktionen sind für die EGL-Dojo-Widgettypen spezifisch, die die Validierung auf Ansichtsebene unterstützen. Eine Liste finden Sie in 'Rich UI - Validierung und Formatierung'.
getValidState
Ausschließlich zur internen Verwendung.
showErrorIndicator
Akzeptiert einen booleschen Wert, der den Fehlerindikator im Widget aktiviert oder inaktiviert. Der Funktionsprototyp lautet wie folgt:
function showErrorIndicator(aboolean boolean in);
showErrorMessage
Akzeptiert eine Fehlernachricht zur Anzeige in der Fehlernachricht-QuickInfo neben dem Widget. Die QuickInfo wird angezeigt, wenn das Widget den Fokus erhält, und ausgeblendet, wenn das Widget den Fokus verliert. Der Funktionsprototyp lautet wie folgt:
function showErrorMessage(msg string in);

Weitere unterstützte Eigenschaften und Funktionen sind in 'Widgeteigenschaften und -funktionen' sowie in 'Widgetstile' beschrieben.


Feedback