setFocus

Define o foco de teclado para o objeto de formulário especificado pela expressão da sintaxe de referência.

Apenas está disponível para aplicativos clientes.

Quando o argumento param1 está omitido ou nulo, o setFocus executa uma operação de foco limpo. Se qualquer objeto de formulário tiver o foco de entrada, o foco será removido desse objeto e todas as edições pendentes nesse objeto serão enviadas, sujando o documento se for apropriado. Se o envio das alterações causar um erro de validação, esse erro será exibido. Se nenhum objeto de formulário tiver o foco de entrada, o argumento zero setFocus não fará nada.

Não é possível usar setFocus com os eventos form:ready, layout:ready ou initialize.

Sintaxe

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

Parâmetros

param

(Opcional) Uma string válida que representa uma expressão de sintaxe de referência totalmente qualificada para o objeto de formulário.

Retorna

Vazio

Aplica-se a

Modelo	Objeto
Modelo de host	hostPseudoModel

Versão

XFA 2.6

XFA 2. 1 (obsoleto)

Exemplos

JavaScript

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

FormCalc

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