Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: DI-2286

Desabilitar componente

Desabilita um componente

.

Parâmetros de Entrada

NomeTipoDoc
Parâmetro 1stringIdentificador do componente

Compatibilidade

Image Removed Servidor

Image Removed Cliente

Exemplo 1

A função abaixo desabilita uma entrada de texto através do seu identificador textinput-nome.

Image Removed

Utilização da função

A utilização da função Desabilitar componente depende da forma correta de vinculação do bloco de programação ao formulário contendo os componentes com os quais se deseja interagir.

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


Image Added

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. 


Image Added

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.


Image Added

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


Nesta página

Índice

Para mais informações sobre como fazer tal vinculação acesse, acesse o tópico Propriedades do Blockly da documentação Bloco de programação.