Calc Add-in Número Por Extenso

From The Document Foundation Wiki
Jump to: navigation, search

Como funciona?

Integração com a interface gráfica

Após a instalação, serão acrescentadas duas novas funções para o Calc: VMPEXTENSO e VNPEXTENSO. Ambas podem ser utilizadas a partir do Assistente de Funções, na categoria Suplemento, ou digitadas diretamente pelo usuário numa célula da planilha.

Função VMPEXTENSO

Retorna o texto da pronúncia brasileira de um valor monetário. Recebe dois argumentos:

num: obrigatório; é o valor monetário

grafia: opcional; se omitido usa a vírgula na grafia, senão (qualquer valor) exclui a vírgula

Exemplos de uso

=VMPEXTENSO ( A10 )
onde: A10 é a célula contendo o valor; grafa com vírgula
=VMPEXTENSO ( B10; 1 )
onde: B10 é a célula contendo o valor; grafa sem vírgula
=VMPEXTENSO ( 1234,55 )
onde: 1234,55 é o valor monetário; grafa com vírgula

Função VNPEXTENSO

Retorna o texto da pronúncia brasileira de um número. Recebe três argumentos:

num: obrigatório; é o número

unid: opcional; intervalo de células contendo a unidade e subunidade (singular e plural). Se omitido, escreve a pronúncia do número sem unidade para a parte inteira e acresce centésimo(s) para a fração. Se definido, usa a unidade / subunidade no texto.

grafia: opcional; se omitido usa a vírgula na grafia, senão (qualquer valor) exclui a vírgula

Exemplos de uso

=VNPEXTENSO ( A10 )
onde: A10 é a célula contendo o valor; grafa sem unidade e com vírgula
=VNPEXTENSO ( B10; K1:K4 )
onde: B10 é a célula contendo o valor
K1:K4 é o intervalo com as unidades (por ex: metro, metros, centímetro, centímetros)
=VNPEXTENSO ( D5; K1:K4; 1 )
onde: D5 é a célula contendo o valor
K1:K4 é o intervalo com as unidades (por ex: metro, metros, centímetro, centímetros)
1 indica que a vírgula deve ser excluída da grafia

Nota: No momento, a função VNPEXTENSO não lida com unidades terminadas com a letra a. Por exemplo, será escrito um tonelada em vez de uma tonelada.

Usando as funções em extensões

Após instalado, o add-in pode ser utilizado em macros e extensões. No documento de teste, veja abaixo, existem duas macros exemplificando o uso das funções.

Download

Extensão:Calc Add-in NumeroPorExtenso versão 0.10

Teste:Testa Add-in NumeroPorExtenso

Ajudando

Você pode ajudar testando as funções no seu sistema. Para facilitar, preparei um arquivo do CALC com diversas chamadas das funções. Instale o add-in, baixe o arquivo de teste e abra-o no seu LibreOffice.

Para contribuir com sugestões de melhoria ou informando erros, contate o autor: Noelson Duarte