typeaheadFunction

Die Eigenschaft typeaheadFunction gibt eine Funktion an, die eine Liste von Optionen für Eingabesteuerelemente bereitstellt, die die Worterkennungsfunktion von JSF verwenden. Eingabesteuerelemente mit Worterkennungsfunktion stellen eine Liste von Optionen auf der Grundlage der ersten paar Zeichen dar, die Benutzer in das Steuerelement eingeben. Anschließend können Benutzer eine dieser Optionen auswählen oder die Eingabe eines anderen Texts fortsetzen.

Die von typeaheadFunction angegebene Funktion muss diese Regeln befolgen:
  • Die Funktion muss sich im JSF-Handler, einem Bibliotheksabschnitt oder in einer eigenständigen Funktion im Gültigkeitsbereich befinden.
  • Die Funktion darf nur einen Parameter empfangen: eine Zeichenfolge (STRING), die den Text darstellt, den der Benutzer in das Eingabesteuerelement eingegeben hat.
  • Die Funktion muss eine Feldgruppe von Zeichenfolgen (STRING) zurückgeben, die die Worterkennungsoptionen wiedergibt, die im Eingabesteuerelement dargestellt sind. Diese Zeichenfolgen müssen für das Format der Variablen angemessen sein, die typeaheadFunction angibt. Wenn beispielsweise eine Variable CHAR dateFormat angegeben hat, prüft EGL nicht, dass die Zeichenfolgen mit dem Format kompatibel sind.
  • Die Funktion kann die Anweisung forward bzw. die Systemfunktionen sysLib.setError() oder sysLib.setErrorForComponentId() nicht verwenden.

Die Funktion wird jedesmal aufgerufen, wenn der Benutzer den Text in der Eingabesteuerung ändert, sodass die Funktion für eine bessere Leistung optimiert wird.

Eine einfachere Möglichkeit, die Optionen anzugeben, die mit der Worterkennungsfunktion verwendet werden sollen, finden Sie unter typeahead. Sie können nicht sowohl typeahead als auch typeaheadFunction im selben Feld angeben.

Kompatibilität

Tabelle 1. Unterstützung für die Eigenschaft 'typeaheadFunction'
Datenelement JSF-Handler VGUI-Datensatz Konsol-UI Textformular Java™ Textformular COBOL Druckformular Java Druckformular COBOL
Ja Ja Nein Nein Nein Nein Nein Nein