Obter Conteúdo da Célula

Obtém o conteúdo de uma célula da planilha Excel.

Parâmetros

Parâmetro

Nome

Doc

Tipo

Parâmetro 1Número da LinhaStringNúmero da linha na planilha, começando sempre com o valor zero, ao invés de 1, como é no Excel padrão.
Parâmetro 2Número da ColunaStringNúmero da coluna na planilha. Os valores inseridos neste campo são numéricos, começando sempre com 0 (equivalente a "A", como é no Excel padrão).
Parâmetro 3AbaStringAba da planilha.

Retorno

Retorna o conteúdo da célula selecionada.

Compatibilidade

 Servidor

Exemplo

Na função abaixo, o objeto da planilha é criado na variável “novo”, com o bloco Criar Planilha Excel, em seguida, a aba (worksheet) “Aba1“ é inserida no objeto da planilha utilizando o bloco Criar Aba. O bloco Inserir Valor na Célula insere na o valor "Exemplo" na célula "0:0", equivalente a "A1" no Excel.

A variável "obter" recebe o retorno do bloco Obter Conteúdo da Célula que está configurado da seguinte forma: os parâmetros Número da Linha e Número da Coluna recebem, respectivamente, o valor "0" (equivalente a célula "A1" no Excel) e no parâmetro Aba, a variável "aba". O bloco imprimir foi utilizado para exibir o resultado da execução do bloco no Console do depurador.

Ao final, utilizamos o bloco Salvar Planilha Excel, passando o objeto criado “novo”, o nome do arquivo da planilha e o endereço onde será salvo.


Figura 1 - Bloco Obter Conteúdo da célula


Na figura abaixo vemos a execução da função da figura 1, o bloco Obter Conteúdo da Célula retornou o valor adicionado pelo bloco Inserir Valor na Célula.


Figura 2 - Resultado do bloco Obter Conteúdo da célula

Sobre o bloco

Diferente da manipulação direta de uma célula em um arquivo Excel, as coordenadas das células são apenas numéricas, sendo que a primeira célula se acessa com o valor 0:0 em vez de A:1.

Mais sobre

Consulte a documentação de suporte do Excel para quaisquer dúvidas.

  • Sem rótulos