setFocus

Hiermee wordt de toetsenbordfocus ingesteld op het formulierobject dat is opgegeven in de verwijzingssyntaxisexpressie.

Deze optie is alleen beschikbaar voor clienttoepassingen.

Wanneer het argument param1 wordt weggelaten of null is, wordt met setFocus een duidelijke focusbewerking uitgevoerd. Als een formulierobject actief is, wordt de focus van dat object verwijderd en worden eventuele bewerkingen die in behandeling zijn bevestigd, waarbij het document wordt vervuild indien van toepassing. Als het bevestigen van de wijzigingen een validatiefout veroorzaakt, wordt die fout weergegeven. Als geen formulierobject actief is, heeft het nulargument setFocus geen effect.

U kunt setFocus niet gebruiken met de gebeurtenis form:ready, layout:ready of initialize.

Syntaxis

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

Parameters

param

(Optioneel) Een geldige tekenreeks met een volledige verwijzingssyntaxisexpressie voor het formulierobject.

Geeft als resultaat

Leeg

Van toepassing op

Model	Object
Hostmodel	hostPseudoModel

Versie

XFA 2.6

XFA 2.1 (afgekeurd)

Voorbeelden

JavaScript

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

FormCalc

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