setFocus

Stellt den Tastaturfokus auf das vom Referenzsyntax-Ausdruck angegebene Formularobjekt ein.

Verfügbar nur für Client-Anwendungen.

Wird das param1-Argument ausgelassen oder ist es gleich null, führt setFocus einen „clear focus“-Vorgang aus. Ist der Fokus auf einem Formularobjekt, wird dieser von dem Objekt entfernt und ausstehende Änderungen an diesem Objekt werden ausgeführt, was eventuell zum Speichern unnötiger Daten im Dokument führt. Führen die vorgenommenen Änderungen zu einem Prüffehler, wird eine entsprechende Fehlermeldung angezeigt. Hat kein Formularobjekt den Eingabefokus, löst das zero-Argument setFocus keinen Vorgang aus.

setFocus kann nicht mit den Ereignissen form:ready, layout:ready oder initialize verwendet werden.

Syntax

Reference_Syntax.setFocus( OBJECT param ) 
Reference_Syntax.setFocus( STRING param ) (deprecated) 

Parameter

param

(Optional) Eine gültige Zeichenfolge zur Darstellung eines gültigen Referenzsyntax-Ausdrucks für das Formularobjekt.

Rückgabe

Leer

Gilt für

Version

XFA 2.6

XFA 2. 1 (nicht mehr unterstützt)

Beispiele

JavaScript

xfa.host.setFocus(xfa.form.form1.TextField1);

FormCalc

xfa.host.setFocus("xfa.form.form1.TextField1")