Focar componente

Essa função é utilizada para focar Ativa o foco em um determinado componente presente na tela.

Compatibilidade

Image Removed Servidor

Image Removed Cliente

Exemplo

Image Added

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-

Image Removed

Figura 1 - Bloco Focar componente

Ao clicar no botão "Button", a função da figura 1 será executada e o componente visual Entrada de texto será selecionado automaticamente. 

.

Image Removed

Figura 2 - Após clicar no botão, o foco vai para o componente entrada de texto

• 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. 

Image Added

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. 

Image Added

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.

Image Added

Figura 2.2 - Resultado após a execução da função