Calc Add-Ins do OpenOffice.org são extensões especiais para o Calc no OpenOffice.org. Calc Add-Ins provêm novas funções embutidas
para a aplicação planilha que podem ser utilizadas diretamente em documentos planilha, e elas são
encontradas na caixa de diálogo da função na aplicação. Add-Ins provêem um maneira fácil de adicionar novas funções
para as funções existentes. Por exemplo, você pode utilizar Add-Ins para adicionar funções de cálculos financeiros especializados
ao Calc.
Add-Ins são criados como componentes UNO que implementam um interface provedora de um serviço especial para Add-Ins. O
assistente de projeto Calc Add-Ins do OpenOffice.org abstrai dos componentes UNO específicos e
simplifica a tarefa de implementações de novas funções.
O assistente ajuda a definir todas as informações necessárias para novas funções Add-In:
Nome da função
O nome da função implementada que é usada na definição da interface UNOIDL, no arquivo de configuração
que identifica o nó da seção para essa função, e quando você quer utilizar a função Add-In
programadamente.
Nome de exibição
Uma função humanamente legível ou nome do parâmetro que é mostrado na interface com o usuário na caixa da diálogo da função.
Esse nome é localizável e é comum especificar ao menos um nome em inglês.
Descrição
Uma descrição humanamente legível da função ou parâmetro que é mostrado na interface com o usuário na caixa da diálogo da
função. Essa descrição é localizável e é comum especificar ao menos uma descrição em inglês.
Categoria
A caixa de diálogo da função categoriza as funções em diferentes categorias e você pode selecionar uma
categoria pré-definida onde a nova função deve aparecer posteriormente na caixa de diálogo da função.
Nome de exibição da categoria
O nome de exibição da categoria é opcional. Você pode apenas selecionar uma lista de categorias pré-definidas.
Nome de compatibilidade
Nomes de compatibilidade são nomes localizados de funções Add-In que são usados para importar arquivos de outras
aplicações. Se, na importação, um nome de função localizado é lido, a lista de nomes de compatibilidade é utilizada para
encontrar o nome interno da função. Para mais informações sobre nomes de compatibilidade por favor leia a
seção apropriada no Guia do Desenvolvedor.
Tipo de retorno
O tipo do retorno da função Add-In. A lista provê apenas tipos válidos. Funções Add-In
apenas permitem um subconjunto de tipos UNOIDL como tipos de retorno.
Nome do parâmetro
A implementação do nome do parâmetro que é usado na definição da interface UNOIDL. Você pode
definir um nome de exibição localizado e uma descrição para parâmetro bem como para a própria função.
Tipo do parâmetro
O tipo do parâmetro de um parâmetro Add-In. A lista provê apenas tipos válidos. Funções Add-In
apenas permitem um subconjunto de tipos UNOIDL como tipos de parâmetro.
Utilizando funções Add-In no OpenOffice.org
Após você ter implantado uma extensão Calc Add-In em uma instalação do OpenOffice.org você pode utilizá-la diretamente pela
função embutida na caixa de diálogo no Calc.
Selecione uma função Add-In e clique próximo. Siga o assistente da função para parametrizar a função e inserir
a função no documento planilha aberto.
Funções Add-In podem ser utilizadas da mesma maneira que funções regulares embutidas.
