|
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.
|
Version
XFA 2.6
XFA 2. 1 (nicht mehr unterstützt)
JavaScript
xfa.host.setFocus(xfa.form.form1.TextField1);
FormCalc
xfa.host.setFocus("xfa.form.form1.TextField1")
|
|
|
