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