Ativa o foco em um determinado componente presente na tela.
Figura 1 - Bloco Focar componente
Compatibilidade
- Bloco cliente: cronapi.screen.focusComponent()
- Bloco servidor: cronapi.screen.focusComponent() - executado a partir da chamada do bloco cliente.
Retorno
Bloco não possui retorno.
Parâmetros
id
Identificador (id
) do componente que será focado. Para selecioná-lo, é necessário vincular o bloco de programação a um formulário de referência, confira no tópico Propriedades do Blockly da documentação Bloco de Programação.
- Posição: 1
- Inglês: id
- Tipo: Objeto / Object
- Exemplo: "
crn-textinput-290605
"
Exemplo
A função a seguir apresenta um exemplo de uso do bloco Focar componente. Após vincular um formulário de referência nas configurações do Editor, selecionamos, no parâmetro id do bloco, o identificador de um componente entrada de texto presente no formulário.
Figura 2 - Função que foca um componente
A figura 2.1 apresenta a view antes da ativação do botão. Como pode-se observar, a view possui dois componentes entrada de texto, onde o primeiro se refere ao nome do usuário e o segundo, o endereço. Inicialmente inserimos dados apenas no primeiro componente.
Figura 2.1 - Resultado antes da execução da função
Ao acionar o botão "Focar Componente", alteramos o foco para o segundo componente entrada de texto, que passa a conter o cursor de digitação.
Figura 2.2 - Resultado após a execução da função