Extensions/Projects/NumeroPorExtenso/pt-br

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:[[Media:NumeroPorExtenso.oxt|Calc Add-in NumeroPorExtenso versão 0.10]]

Teste:[[Media:TestaAddin NumeroPorExtenso.ods|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: [mailto:noelsonalves@yahoo.com Noelson Duarte]