setFocus

Imposta lo stato attivo sull'oggetto modulo specificato dall'espressione della sintassi di riferimento.

È disponibile solo per le applicazioni client.

Quando l'argomento param1 viene omesso o ha valore nullo, setFocus esegue un'operazione di cancellazione dello stato. Se un oggetto modulo è in uno stato attivo, tale stato viene rimosso dall'oggetto e le eventuali modifiche in sospeso in tale oggetto vengono effettuate, rendendo il documento non aggiornato, se appropriato. Se le modifiche apportate causano un errore di convalida, tale errore viene visualizzato. Se nessun oggetto modulo è in uno stato attivo, il setFocus con argomento zero non ha alcun effetto.

Non è possibile utilizzare setFocus con gli eventi form:ready, layout:readyo initialize.

Sintassi

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

Parametri

param

(Facoltativo) Stringa valida che rappresenta l'espressione di sintassi di riferimento completa dell'oggetto modulo.

Valore restituito

Vuoto

Si applica a

Modello	Oggetto
Modello Host	hostPseudoModel

Versione

XFA 2.6

XFA 2. 1 (Non approvato)

Esempi

JavaScript

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

FormCalc

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