Desabilita um componente que possua a propriedade Identificador (id), bloqueando o seu acesso.

Figura 1 - Bloco Desabilitar componente

Compatibilidade

• Bloco cliente: cronapi.screen.disableComponent()
• Bloco servidor: cronapi.screen.disableComponent() - executado a partir da chamada do bloco cliente.

Retorno

Bloco não possui retorno.

Parâmetros

Identificador

Identificador (id) do componente que será desabilitado. 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: Get Identifier
• Tipo: Objeto / Object
• Exemplo: "crn-textinput-290605"

Exemplo

A função a seguir apresenta um exemplo de uso do bloco Desabilitar componente. Após vincular um formulário de referência nas configurações do blockly, selecionamos, no parâmetro Identificador do bloco, o identificador (id) de um componente entrada de texto presente no formulário. 

Figura 2 - Exemplo de uso do bloco Desabilitar componente

A imagem abaixo apresenta o resultado de execução da função da Figura 2, a qual foi associada ao evento "Ao clicar" do botão "Desabilitar componente". Como pode-se observar, inicialmente, o componente entrada de texto está habilitado e, nele, é possível adicionar qualquer conteúdo. Após clicar no botão do formulário, a função é executada, desabilitando o componente e bloqueando a inserção de conteúdo.

Figura 2.1 - Resultado de execução da função da Figura 2