# O Manual do &kaddressbook;

Tobias
Koenig

    tokoe@kde.org

Steffen
Hansen

    hansen@kde.org

Don
Sanders

    &Don.Sanders.mail;

Michel
Boyer de la Giroday

    michel@klaralvdalens-datakonsult.se

Michael
Skiba

    michael@michael-skiba.de

Marcus
Gama

    marcus.gama@gmail.com

Tradução
2008-09-20
4.1 (&kde; 4.1.2)
&FDLNotice;

O &kaddressbook; é o livro de endereços do &kde;.

KDE
kaddressbook

## Introdução

O &kaddressbook; é o livro de endereços do &kde;. Ele permite gerenciar os seus contatos de forma eficiente e confortável. Uma vez que se baseia na biblioteca do 'kabc', ele suporta o conceito de recursos, que poderé ser usado para ler e gravar os contatos em vários locais — não só o sistema de arquivos local, mas também em servidores LDAP e bases de dados em SQL.

A interface do usuário é semelhante à do MS Outlook e suporta visões diferentes para diferentes representações dos dados dos contatos. Além disso, oferece uma procura incremental por todos os campos e uma barra de posicionamento para o acesso rápido a itens individuais. Uma vez que a biblioteca de camada usa o formato vCard (definido no RFC 2426) como meio de armazenamento padrão, o &kaddressbook; reflete principalmente os campos suportados por este formato na sua interface gráfica para o usuário.

## Utilização do &kaddressbook;

### Começando

Depois de ter iniciado o &kaddressbook; (usando algum dos lançadores de aplicações do &kde;, como o &kickoff;, o &kmenu; clássico ou o Lancelot), inserindo `kaddressbook` na linha de comando ou com a página de Contatos do &kontact;), a janela principal do &kaddressbook; irá aparecer:

Iniciando o &kaddressbook;
O diálogo principal do &kaddressbook;.

O diálogo principal do &kaddressbook;.

### Configurar Recursos

O &kaddressbook; poderá usar vários recursos para ler e guardar os seus contatos. Depois de iniciar o &kaddressbook; pela primeira vez, será instalado um recurso padrão, o qual salva todos os contatos num arquivo vCard em `$`HOME`/.kde/share/apps/kabc/std.vcf`. Você poderá adicionar mais recursos, usando a Janela de Configuração dos Recursos, que está disponível no &systemsettings;, em Avançado->Recursos do &kde;:

O Diálogo de Configurações de Recursos
O Diálogo de Configurações de Recursos.

O Diálogo de Configurações dos Recursos.

Carrega o módulo de configuração para o qual você deseja adicionar os seus recursos, selecionando-o na lista da seção de Recursos. O módulo para configurar os recursos do &kaddressbook; é o Contatos.

Lance a janela de Configuração do Recurso, pressionando o botão Adicionar.... Escolha o recurso que deseja adicionar ao seu módulo Contatos e clique OK para confirmar a sua escolha.

Akonadi

  A ser escrito

Pasta

  Cada contato é armazenado no seu próprio arquivo;

Arquivo

  Todos os contatos são armazenado em um arquivo único;

Servidor de GroupDAV (p.ex. Open Groupware)

  A ser escrito

Servidor Novell GroupWise

  A ser escrito

Livro de Endereços num Servidor IMAP com o &kmail;

  Este recurso armazena os contatos como mensagens num servidor de IMAP. O &kmail; é usado para acessar o servidor de IMAP; assim, se você usar este tipo de recurso, o &kmail; será aberto sempre que acessar o livro de endereços, se este (ou o &kontact;) não estiverem já em execução.

LDAP

  Todos os contatos são armazenados num servidor LDAP;

Rede

  todos os contatos serão armazenados num arquivo, que poderá estar localizado num servidor remoto (&eg;, através de &HTTP;, WebDAV, &FTP; ou Fish).

Servidor OpenXchange

  Este recurso guarda os contatos num servidor do OpenExchange.

Livro de Endereços num Servidor Scalix com o &kmail;

  A ser escrito

Servidor Openexchange do Suse Linux

  Este recurso guarda os contatos num servidor de OpenExchange ou servidor de 'groupware' OpenExchange do SUSE &Linux;.

Servidor eGroupware (via XML-RPC)

  A ser escrito

Depois de selecionar o tipo, aparecerá outro diálogo, onde você poderá configurar as opções específicas do recurso.

Os recursos Arquivo e Diretório suportam formatos diferentes para guardar os contatos:

vCard

  os contatos serão guardados no formato vCard, como especificado no RFC 2426;

Binário

  os contatos serão salvos em um formato binário — isto aumenta a performance durante a leitura e a gravação, mas não é portável como o formato vCard;

Contas do Repositório do KDE

  A ser escrito

O &kaddressbook; necessita de um recurso padrão, onde todos os contatos deverão ser guardados se não for especificado nenhum outro recurso. Por esta razão, depois de iniciar o &kaddressbook; pela primeira vez, existe já um recurso disponível. Se você quiser usar outro recurso como recurso padrão, use a opção Usar como Padrão para selecioná-lo. O novo recurso padrão deverá ter permissões para leitura e escrita e deverá estar ativo, caso contrário você não poderá selecioná-lo.

### Gerenciando Contatos

Para criar ou editar os contatos, o &kaddressbook; oferece um diálogo onde você poderá inserir todos os dados que também se encontram disponíveis num vCard.

O Diálogo de Contato
O Diálogo de Contato.

O Diálogo de Contato.

#### Página de Configuração Geral

Na página Geral, você poderá indicar as informações básicas sobre um contato, como por exemplo os seus endereços, números de telefone e endereços de e-mail.

##### Processamento Automático de Nomes

O &kaddressbook; tenta proporcionar uma fácil inserção dos nomes ao analisá-los automaticamente. Para funcionar convenientemente, é necessário às vezes adicionar alguns prefixos personalizados, sufixos ou inclusões na janela de configuração. Todavia não há nenhum algoritmo perfeito, assim poderá ocorrer que ele processe incorretamente o seu nome. Neste caso, você poderá desativar a análise automática do nome na janela de edição do nome, que fica disponível ao clicar em Editar o Nome... na janela de contatos. Se você quiser desativar a análise para todos os contatos novos, desative a análise automática globalmente na janela de configuração.

##### Nome Formatado

O nome formatado de um contato é usado pelos outros programas para representá-lo. O &kaddressbook; oferece três tipos pré-definidos de nomes formatados:

Personalizada

  <ver abaixo>

Nome Simples

  <nome próprio> <sobrenome>;

Nome Completo

  <prefixo> <nome próprio> <nome adicional> <sobrenome> <sufixo>;

Nome Invertido com Vírgula

  <sobrenome>, <nome próprio>.

Nome Invertido

  <sobrenome>, <nome próprio>.

Organização

  <Nome da Organização>

Se os tipos acima apresentados não corresponderem às suas necessidades, você poderá selecionar o tipo de nome Personalizado, onde você poderá adicionar o seu próprio nome formatado — essa configuração poderá ser feita no diálogo de edição dos nomes. Para indicar um tipo de nome formatado para os contatos novos, use o diálogo de configuração.

##### Números de Telefone

Aqui você poderá inserir os números de telefone do seu contato. Assim como 'é possível usar os números de telefone e celular, também é possível definir os números de Fax, RDIS e muitos outros tipos. O número poderá conter praticamente qualquer caracter, assim é possível formatar o número como bem desejar, incluindo a adição de letras.

Se três números não forem suficientes, basta pressionar Adicionar para obter novos campos novos para inserir um número.

Se o tipo do número for o Telefone, o Celular ou o Fax, você poderá seleccionar um programa a executar quando clicar nele. (em Configuração → Geral)

##### Endereços

Aqui você poderá editar os endereços do seu contato. Você poderá fazer isso ao pressionar no botão Editar os Endereços... e inserir a Rua, Caixa Postal, Localidade, Código Postal e País. Depois de fazer isso, você poderá procurar o endereço no mapa, clicando para isso no endereço (você poderá mudar o texto/serviço de mapas usado pelo &kaddressbook; na sua configuração).

Você poderá também criar uma legenda que será apresentada em vez do endereço real (contudo, a pesquisa de mapas irá usar o endereço real).

Você poderá também definir diferentes endereços (i.e., um para o trabalho e outro para casa). Também é possível definir dois endereços de Residência.

##### E-mails

Você poderá inserir aqui endereços de e-mail para os seus contatos. Poderá também definir um endereço como sendo o endereço-padrão.

Se você atribuir uma foto ao seu contato, na página Diversos, o &kmail; irá exibí-la ao acessar esses endereços.

Estes endereços serão usados no &kmail; se você escrever o nome da pessoa nos campos Para, CC ou BCC de uma mensagem nova.

##### Mensageiro Instantâneo

O campo de texto Endereço IM contém o Endereço do Mensageiro Instantâneo preferido para este contato. Para adicionar, ver e editar os endereços de IM adicionais, clique no botão Editar os Endereços IM.... A janela para Edição dos Endereços de Mensagens Instantâneas irá aparecer.

O Diálogo de Edição dos Endereços de IM
O diálogo para Editar os Endereços de IM.

O diálogo para Editar os Endereços de IM.

Um contato poderá ter vários endereços de mensagens instantâneas associados a ele. As outras aplicações que usarem o sistema Kimproxy, como o &kopete; ou o &konversation;, poderão interagir com esta informação. Por exemplo, você poderá associar um contato no IRC com um contato no seu livro de endereços. Isto não poderá ser feito automaticamente, assim você terá quee fazer a associação manual no programa específico.

Se você não estiver interessado se eles estão associados a outra aplicação e apenas desejar guardar os endereços de mensagens instantâneas com o contato, então poderá apenas adicioná-los e editá-los. Caso contrário, recomenda-se que deixe as aplicações fazerem as alterações sem que você interfira com elas.

Para mais informações sobre como adicionar novos endereços de Mensageiros Instantâneos, veja no manual do &kopete; ou no manual do &konversation;.

##### Categorias

As categorias ajudam-no a ordenar e agrupar os seus contatos. Você poderá simplesmente adicionar um contato a um ou mais grupos, pressionando o botão Selecionar Categorias....

Para adicionar a sua própria categoria ou remover uma categoria não usada, você poderá clicar no botão Editar Categorias.... Aqui você poderá editar, adicionar e remover categorias. Note que esta janela é automaticamente iniciada no modo de Edição.

##### Público, Privado e Confidencial

Os três modos Público, Privado e Confidencial fazem parte da norma vCard e são implementados desta maneira. Eles possibilitam outra forma de agrupar os seus contatos.

#### Página de Detalhes

Este é o local onde você poderá guardar os detalhes adicionais sobre os seus contatos.

Os campos são, na sua grande parte, auto-explicativos. Você perceberá que as datas de Aniversário e Nascimento aparecem nas Datas Especiais do resumo do &kontact;.

#### Página de Configurações da Criptografia

Nesta página, você poderá definir as preferências que dizem respeito à criptografia para um determinado contato. No momento em que isto foi escrito, somente o &kmail; e o &kontact; farão uso destas preferências, ao compor as mensagens. Este mecanismo substitui as preferências de criptografia por destinatário das versões anteriores do &kmail;.

Protocolos Permitidos

  Aqui, você poderá restringir os formatos de mensagens criptográficas que podem ser usados para este contato. Veja a seção sobre os Formatos Criptográficos de Mensagens no manual do &kmail; para uma discussão dos diferentes formatos disponíveis.

Chave de criptografia de OpenPGP preferida, Certificado de criptografia de &smime; preferido

  Aqui, você poderá atribuir uma chave de OpenPGP e/ou certificado de &smime; para usar ao cifrar para este contato. Caso contrário, a procura de chaves ou certificados correspondentes será feita no chaveiro local ou no chaveiro de certificados local.

Preferências da Mensagem

  Aqui, poderá selecionar um conjunto de diretivas para uma interação do usuário, tanto na assinatura como na criptografia.

  <nenhum>

    Sem preferências, use o modo padrão do &kmail;.

  Nunca Assinar, Nunca Criptografar

    Nunca assina (ou criptografa) as mensagens para este contato. Não pede qualquer confirmação (exceto no caso de conflitos com as preferências de outros contatos).

  Assinar Sempre, Criptografar Sempre

    Assina (ou criptografa) sempre as mensagens para o contato. Não pede qualquer confirmação (exceto no caso de conflitos com as preferências dos outros contatos).

  Assinar Sempre Se Possível, Criptografar Sempre Se Possível

    Assina sempre (ou cifra) as mensagens para este contato, quando for possível fazê-lo. Não pergunta nada se não for possível. As situações em que a assinatura poderá não ser possível será quando se incluem outros destinatários que têm preferências de assinatura iguais a "Nunca". As situações em que a criptografia poderá não ser possível incluem a falta de chaves/certificados para este destinatário ou qualquer um dos outros.

  Perguntar

    Pergunta sempre se deve assinar (ou criptografar).

#### Página Diversos

Isto descreve a página Diversos

##### Dados Geográficos

Aqui você poderá indicar a localização geográfica do contato, com a Latitude e a Longitude. Para os "ativar", basta clicar na opção usar os dados geográficos. Depois disso, você poderá tanto indicar as coordenadas manualmente como clicar no botão Editar os Dados Geográficos... para selecioná-los num mapa-mundo.

##### Som

Você poderá guardar uma versão falada do nome aqui. Isto é útil para nomes estrangeiros.

Contudo, isto faz parte da norma vCard 2.1 e só suporta os três formatos: WAVE, PCM, AIFF.

Selecione a opção Guardar como URL se o som estiver guardado numa máquina remota.

##### Foto e Logotipo

Se clicar no ícone do contato, você poderá selecionar e dimensionar uma fotografia para o seu contato.

A fotografia irá aparecer na previsão do contato e no modo de visualização por ícones. Contudo, a imagem do Logotipo só aparecerá no modo de Ícones e apenas se não estiver disponível nenhuma fotografia.

Para restaurar uma fotografia ou logotipo, basta clicar nela com o &RMB; e selecionar a opção Reiniciar.

##### Localização da informação de Livre/Ocupado

Aqui você poderá selecionar a localização da informação de Livre/Ocupado de um contato, que são usadas se adicioná-lo a um evento no &korganizer; ou no calendário do &kontact;.

#### Página de Campos Personalizados

Na página de Campos Personalizados, você poderá adicionar os seus próprios campos, seja apenas para o contato atual ou para todos. É possível usar os seguintes tipos de campos:

Texto

  Aqui você poderá indicar todos os símbolos alfanuméricos

Valor Numérico

  Você só poderá inserir aqui números.

Booleano

  O Booleano é apenas 'sim' ou 'não' ('verdadeiro' ou 'falso', ou como queira chamar). No &kaddressbook;, é apenas uma opção de marcação que poderá assinalar ou desligar.

Data

  Aqui você poderá inserir uma data.

Tempo

  Aqui você poderá inserir uma hora.

Data & Hora

  Aqui você poderá inserir tanto uma data como uma hora.

### Usando Visões

Nesta versão, o &kaddressbook; oferece algumas vistas diferentes, que representam os contatos apresentados de diferentes formas:

Visão de Tabela

  Todos os contatos são listados numa tabela. Eles poderão ser ordenados clicando no cabeçalho da coluna da tabela. As colunas da tabela dependem dos campos, que foram selecionados no diálogo de configuração da visão.

Visão por Ícones

  Os contatos são mostrados como ícones na janela. Se o contato contiver uma fotografia ou um logotipo, ele será usado nesta visão, caso contrário é usado um ícone padrão.

Visão de Cartões

  Todos os contatos são apresentados no formato de cartões. Os cartões contém o nome formatado como título. O conteúdo do cartão depende de quais campos foram selecionados no diálogo de configuração da visão.

O Diálogo de Configurações da Visão
O Diálogo de Configurações da Visão.

O Diálogo de Configurações da Visão.

A página dos Campos oferece-lhe a possibilidade de selecionar quais os detalhes de um contato deverão ser mostrados na vista. Na página do Filtro Padrão você poderá configurar qual o filtro que deverá ser usado para a vista.

### Usando Filtros

Você poderá configurar os filtros no &kaddressbook;, os quais dependem das categorias a que um contato pertence. Por exemplo, você poderá criar um filtro que corresponda a todos os contatos que pertençam às categorias de Família ou Amigos. Mas você poderá definir um filtro que corresponda a todos os contatos que não pertençam a essas categorias. Para gerenciar os filtros, use a janela de configuração dos filtros:

O Diálogo de Configurações dos Filtros
O Diálogo de Configurações dos Filtros.

O Diálogo de Configurações dos Filtros.

Os filtros podem ser usados nas visões para reduzir o número de contatos representados. No diálogo de configuração da visão você poderá indicar qual filtro deverá ser usado por padrão por uma visão.

### Usando Extensões

As extensões estão implementadas como plug-ins no &kaddressbook;, assim os programadores externos ao projeto poderão criar mais extensões. Atualmente, já existem três:

Nenhuma

  Esta seleção não mostra extensões. É uma boa seleção padrão, se você não estiver usando nenhuma das outras extensões para economizar espaço.

Editor de Contatos

  Semelhante à janela de edição de contatos, mas pensado para permitir a edição rápida dos contatos.

Livros de Endereços

  Esta extensão mostra-lhe uma lista com os recursos disponíveis para livros de endereços. Você poderá ativá-los/desativá-los para mostrar/ocultar os itens de um determinado livro de endereços.

  Também é possível Adicionar, Editar ou Remover um recurso; para mais informações sobre o assunto, veja como configurar os recursos.

Gerenciador de Listas de Distribuição

  Esta extensão oferece um gerenciamento simples das listas de distribuição: basta criar uma nova lista e selecionar um contato na janela. Depois de clicar em Adicionar o contato, o contato selecionado passa a fazer parte da lista de distribuição. Existe uma forma mais simples, que consiste em arrastar um contato da janela e soltá-lo no gerenciador de listas de distribuição. Veja o Menu de Configuração para saber como adicionar uma extensão.

A janela principal com a extensão de listas de distribuição.
A janela principal com a extensão de listas de distribuição.

A janela principal com a extensão de listas de distribuição.

### Importar e Exportar

Com a nova plataforma de importação e exportação, o &kaddressbook; oferece um diálogo onde você poderá selecionar quais contatos deverão ser exportados.

O diálogo de exportação de contatos.
O diálogo de exportação de contatos.

O diálogo de exportação de contatos.

#### Importar

O &kaddressbook; é capaz de importar a partir dos seguintes formatos:

vCard

  Com este plugin você consegue importar do formato vCard (RFC 2426).

Livro de Endereços Pessoal do MS Exchange (.PAB)

  Com este item, você poderá importar os seus contatos a partir do seu Livro de Endereços numa agenda pessoal do MS Exchange, que é usado pelo MS Outlook e o MS Outlook Express para guardar os seus dados de contatos.

Livro de Endereços do Eudora

  Com este plugin você consegue importar os seus contatos do cliente de e-mail Eudora.

Lista CSV

  O CSV ('comma separated values' - valores separados por vírgulas) é um formato que é usado por muitas aplicações de livros de endereços.

Livro de Endereços do Opera

  Com este plugin você consegue importar os seus contatos do navegador Web Opera.

Livro de Endereços do KDE 2

  Com este plugin você consegue importar os seus contatos antigos de uma instalação do &kde; 2.

Livro de Endereços LDIF

  O LDIF é uma representação em texto simples dos dados do LDAP, usada pelo &Netscape; e o Mozilla para guardar os seus dados do livro de endereços.

Livro de Endereços GMX

  A ser escrito.

#### Exportar

O &kaddressbook; é capaz de exportar para os seguintes formatos:

vCard 2.1 & 3.0

  Com este item, poderá exportar os seus contatos para o formato vCard (RFC 2426). Você poderá exportá-lo tanto para o formato 2.1 como para um formato compatível com a versão 3.0 da norma vCard.

Lista CSV

  O CSV ('comma separated values' - valores separados por vírgulas) é um formato que é usado por muitas aplicações (também nas de livros de endereços); ele guarda os dados do contato em texto simples, separando cada item com vírgulas. Isto torna o CSV muito flexível e bom para a interação com programas.

Livro de Endereços LDIF

  O LDIF é uma representação em texto simples dos dados do LDAP, usada pelo &Netscape; e o Mozilla para guardar os seus dados do livro de endereços.

Livro de Endereços GMX

  A ser escrito.

Menu de Favoritos

  Isto exporta os URLs armazenados nos seus contatos para o sistema de favoritos do &konqueror;.

Dados Geográficos

  A ser escrito.

### Consultas LDAP

O &kaddressbook; pode ser usado para importar as informações dos endereços a partir dos servidores de LDAP para o livro de endereços no livro de endereços local, usando a janela de pesquisa na LDAP.

Para configurar (um conjunto) de servidores de LDAP, use o diálogo de configuração.

Na barra de ferramentas principal do &kaddressbook;, está disponível um botão com a imagem de uma lupa sobre um livro. Use este botão para abrir o diálogo de pesquisa no LDAP. O diálogo em si é bastante simples. Basta digitar uma parte do nome, endereço de e-mail ou do número de telefone e pressionar o botão Procurar.

Quando aparecerem os resultados na lista, é possível selecionar um ou mais endereços e usar o Adicionar Selecionados para importar os endereços selecionados para o livro de endereços local ou clicar no Enviar para os Selecionados, para invocar o programa de e-mail e escrever um e-mail para os destinatários selecionados.

A opção Pesquisa recursiva está ativo por padrão. Isto fará com que a pesquisa na LDAP considere todos os objetos abaixo da DN de base de cada servidor. Se você só quiser considerar os objetos que estejam um nível abaixo da base, desligue esta opção. Se tiver dúvidas, deixe-a selecionada.

### Preferências

Você poderá alterar vários aspectos do comportamento do &kaddressbook; na janela de preferências; a janela poderá ser acessada através de Configurações Configurar o &kaddressbook;... ou no ícone da barra de ferramentas.

Configurando o &kaddressbook;
O diálogo de preferências.

O diálogo de preferências.

#### A Página Geral

##### A Página Geral

Usar o clique simples do &kde;

  Se estiver assinalada esta opção, o &kaddressbook; irá prestar atenção à opção do clique simples do &kde;.

Análise Automática do Nome para os endereços novos

  Se estiver assinalado, o recurso de análise automática do nome é usado para os endereços novos.

Limitar visualização não filtrada a 100 contatos

  Se estiver assinalada, o &kaddressbook; só irá mostrar 100 contatos na lista de contatos, se não estiver aplicado nenhum filtro.

Tipo de editor do destinatário

  Você poderá selecionar tanto o "Editor Simples" como o "Editor Completo".

  O modo de edição Simples só lhe permite inserir o nome (que será processado automaticamente, se estiver ativo) e um endereço de e-mail.

Intersecções dos Programas

  Aqui você poderá indicar os comandos que deverão ser executados quando você clicar num número de telefone ou número de SMS na página dos detalhes.

##### A Página Contato

O &kaddressbook; poderá analisar automaticamente um nome nas suas partes. Para ter a certeza que isto funciona em muitos casos, você poderá adicionar aqui as pates adicionais do nome, como os prefixos, os sufixos e as inclusões.

Prefixos

  Aqui você pode gerenciar os prefixos como 'Prof.' ou 'Dr.'.

Inclusões

  Aqui você poderá gerenciar as inclusões dos nomes como o 'do', 'da', 'de', que fazem parte normalmente dos nomes brasileiros.

Sufixos

  Aqui você poderá gerenciar os sufixos dos nomes como 'Filho' ou 'Júnior'.

Nome Formatado Padrão

  Aqui você poderá escolher o tipo padrão de formatação para os nomes que deverá ser usado para os contatos novos.

#### A Página Pesquisa LDAP

Nesta página você poderá configurar os servidores de LDAP que deverão ser usados para as pesquisas de LDAP do &kaddressbook;.

Use o Adicionar Máquina... para adicionar e configurar um novo servidor.

Configurar a Pesquisa por LDAP
Exemplo da Configuração da Pesquisa por LDAP.

A janela para Adicionar uma Máquina - Exemplo da configuração da Pesquisa por LDAP.

Note que alguns dos campos poderão estar desativados, dependendo das suas seleções.

Você pode incluir e excluir os servidores conforme selecione ou não a sua opção na lista dos servidores. Pressione OK para fechar a janela.

Você poderá configurar a ordem de procura se subir ou descer os servidores na lista. Isto poderá ser feito usando as setas correspondentes do lado direito da janela.

#### A Página Páginas Personalizadas

Esta seção permite-lhe adicionar os seus próprios elementos da &GUI; para guardar os seus próprios valores no &kaddressbook;. Proceda da seguinte forma:

- 1. Clique em Editar com o QT Designer.(nota: o &Qt; Designer terá que estar instalado, caso contrário, o botão estará desativado)
- 2. Na janela, selecione o Widget (Elemento Gráfico) e depois clique OK.
- 3. Adicione os seus elementos ao formulário.
- 4. Salve o arquivo na pasta proposta pelo &Qt; Designer
- 5. Feche o &Qt; Designer

No caso de já ter um arquivo do desenhador (*.ui) localizado em outro ponto qualquer do seu disco rígido, basta escolher Importar a Página...

IMPORTANTE: O nome de cada campo que colocar no formulário deverá começar por 'X_'; por isso, se você quiser que o elemento corresponda ao seu campo personalizado 'X-XPTO', mude o nome para 'X_XPTO'.

IMPORTANTE: O elemento irá editar os campos personalizados com um nome de aplicação igual ao &kaddressbook;. Para mudar o nome da aplicação a editar, mude o nome do elemento no &Qt; Designer.

## Referência de Comandos

### O Menu Arquivo

Arquivo Novo Novo Contato...

  Abre o editor de contatos para adicionar um novo contato.

Arquivo Novo Nova Lista de Distribuição...

  Abre o editor das listas de distribuição para adicionar uma nova lista.

&Ctrl;S Arquivo Salvar

  Salva os contatos alterados.

Arquivo Importar

  Lista todos os módulos de importação disponíveis.

Arquivo Exportar

  Lista todos os módulos de exportação disponíveis.

&Ctrl;P Arquivo Imprimir...

  Imprime os contatos atualmente selecionados.

Arquivo Enviar E-mail para o Contato...

  Abre o programa de e-mail preferido com os contatos atualmente selecionados como destinatários.

Arquivo Enviar Contato...

  Abre o programa de e-mail preferido com os detalhes dos contatos atualmente selecionados como vCards em anexo.

Arquivo Conversar Com...

  Se uma aplicação de Mensagens Instantâneas estiver aberta (como o &kopete;), o seu contato estiver conectado, e se existir uma associação a este contato, este item irá aparecer. O mesmo permitirá abrir uma nova janela de conversação com o seu contato.

&Ctrl;Q Arquivo Sair

  Sai do &kaddressbook;.

### O Menu Editar

&Ctrl;Z Editar Desfazer

  Desfaz a última alteração.

&Ctrl;&Shift;Z Editar Refazer

  Refaz a última ação desfeita.

&Ctrl;X Editar Recortar

  Corta os contatos selecionados atualmente e coloca-os na área de transferência.

&Ctrl;C Editar Copiar

  Copia os contatos selecionados atualmente para a área de transferência.

&Ctrl;V Editar Colar

  Cola o conteúdo da área de transferência no livro de endereços (se estiver num formato válido).

Editar Copiar Contato Para...

  A ser escrito.

Editar Mover Contato Para...

  A ser escrito.

Delete Editar Remover Contato

  Apaga os contatos atualmente selecionados.

Editar Guardar Contato Em...

  Se estiverem disponíveis dois ou mais recursos, você poderá mover um contato para outro recurso.

  Lembre-se por favor: Esta janela só irá funcionar se estiverem disponíveis dois ou mais recursos; se só existir um, não irá acontecer nada (este é um erro conhecido).

&Ctrl;A Editar Selecionar Tudo

  Seleciona todos os contatos.

Editar Mesclar Contatos

  Para mesclar os contatos, basta selecionar dois ou mais contatos e escolher a opção Mesclar os Contactos. O último contato será o contacto mesclado, que irá conter toda a informação de ambos.

Editar Selecionar Categorias...

  Abre uma janela onde você poderá definir as categorias para todos os contatos atualmente selecionados. Quando as categorias selecionadas forem diferentes das dos contatos, o programa perguntará se deseja mesclar essas diferenças ou se as categorias deverão sim ser substituídas.

Editar Definir como Dados Pessoais do Contato

  Marca o contato selecionado atualmente como o contato 'Quem Sou Eu', que representa os dados do usuário. Você deverá ter um desses contatos, porque os outros aplicativos como o &kmail; e o &kword; poderão fazer uso desses dados. Deste modo, você não terá que inserí-los separadamente para cada aplicativo .

### O Menu Ver

Ver Selecionar Visão

  Lista todas as visões disponíveis.

Ver Adicionar Vista...

  Abre um diálog para criar uma nova visão .

Ver Modificar Visão...

  Abre um diálogo onde você poderá modificar a configuração da visão atual .

Ver Remover Visão

  Remove a visão atual.

Ver Editor de Contatos

  Mostra ou oculta a janela de edição dos contatos.

Ver Editor de Listas de Distribuições

  Mostra ou oculta a janela de edição das listas de distribuição.

Ver Livros de Endereços

  Mostra ou oculta a janela do livro de endereços.

Ver Atualizar Visão

  Atualiza o conteúdo atual da visão.

### O Menu Ferramentas

Este menu contém as ferramentas para atuar na base de dados dos contatos.

Ferramentas Pesquisa no LDAP

  Abre o diálogo de pesquisa para os endereços localizados nos servidores LDAP. Você poderá configurar o servidor no diálogo de configuração.

### O Menu Configurações

Este menu contém as opções para configurar o &kaddressbook;, alterando a sua aparência, os seus atalhos e o seu comportamento padrão.

Configurações Mostrar a Barra de Ferramentas

  Comuta (ativa ou desativa) as barras de ferramentas.

Configurações Mostrar Barra de Salto

  Comuta (ativa ou desativa) a Barra de Salto.

Configurações Mostrar/Ocultar Detalhes

  Comuta (ativa ou desativa) a Página dos Detalhes.

Configurações Editar os Filtros...

  Abre um diálogo onde você poderá editar os filtros.

Configurações Configurar Atalhos...

  Abre um diálogo para alterar a configuração dos atalhos de teclado. Ao usar esta opção você poderá alterar os atalhos padrão de teclas para os comandos do &kaddressbook; ou criar novos.

Configurações Configurar Barras de Ferramentas...

  Abre um diálogo para configurar a barra de ferramentas. Você poderá adicionar e remover os botões da barra de ferramentas para os comandos do &kaddressbook; com esta opção.

Configurações Configurar o &kaddressbook;...

  Abre o diálogo de preferências.

### O Menu Ajuda

&help.menu.documentation;

## Opções da Linha de Comando

O &kaddressbook; suporta alguns argumentos na linha de comando, que poderão ser usados para influenciar o comportamento inicial:

`kaddressbook` `-a, --addr <e-mail>`

  Mostra o editor de contatos com o endereço de e-mail indicado.

`kaddressbook` `--uid <uid>`

  Mostra o editor de contatos com o UID indicado.

`kaddressbook` `--editor-only`

  Lança apenas no modo de edição.

`kaddressbook` `--new-contact`

  Lança o editor para um contato novo.

O &kaddressbook; também suporta as outras opções da linha de comando comuns aos programas do &kde; e do &Qt;. Você poderá obter uma lista com estas opções usando o ``--help``, o ``--help-kde`` e o ``--help-qt``.

## Opções sem Representação na Interface do Usuário

Além das opções apresentadas na janela de configuração, algumas opções só poderão ser definidas no arquivo de configuração ($KDEHOME/share/config/kaddressbookrc) ou através do KIOSK.

ContactListAboveExtensions

  Se estiver ativa, as extensões (p.ex., o editor de listas de distribuição) aparecem abaixo da lista de contatos, sem ser numa coluna separada. Por padrão, esta opção está desativada. Para ativar esta opção, adicione uma linha semelhante à seguinte (sob a seção [MainWindow]):

      ContactListAboveExtensions=true

## Créditos e Licença

&kaddressbook; - Livro de Endereços do &kde;

Copyright (c) 1997-2007, A Equipe &kde;-PIM

O &kaddressbook; foi criado originalmente em 1997 pelo &Don.Sanders; &Don.Sanders.mail;. Atualmente é mantido pelo &Tobias.Koenig; tokoe@kde.org.

Tradução de Marcus Gamamarcus.gama@gmail.com

&underFDL;