# Manual do &klipper;

## Introdução

O &klipper; é um utilitário de área de transferência do &plasma;. Ele armazena um histórico da área de transferência, e permite ligar tipos de conteúdo da área de transferência a ações de aplicativos. Por favor, comunique qualquer problema ou pedido de recurso no Bugzilla do KDE.

## Usando o &klipper;

### Uso Básico

Você pode usar o &klipper; na área de notificação como um widget do &plasma; ou como um aplicativo normal. Ambos compartilham a mesma funcionalidade, mas possuem uma interface diferente e mostram o último item do histórico ao passar o ponteiro do mouse sobre o ícone do &klipper; na área de notificação:

O ícone do &klipper;. O ícone do &klipper;

O widget do &klipper; ficará oculto se a área de transferência estiver vazia.

Para mostrar o histórico da área de transferência, clique no ícone do &klipper; na área de notificação.

#### Widget do &klipper;

O widget do &klipper;. O widget do &klipper;

Passe o ponteiro do mouse sobre um item para aparecerem quatro ícones, os quais lhe permitem efetuar uma ação, mostrar o código de barras, editar o conteúdo ou remover o item do histórico. Use o &spectacle; para capturar os códigos de barras e depois salvá-los.

Você pode procurar pelo histórico da área de transferência abrindo-o (clique no &klipper;) e digitando a sua pesquisa. Os resultados são atualizados à medida que você digita. Para limpar o histórico da área de transferência, clique no ícone à direita do campo de pesquisa.

A ação Configurar área de transferência... no menu de contexto abre a caixa de diálogo de configuração.

### Ações

O &klipper; pode executar ações sobre os conteúdos da área de transferência baseado na correspondência do mesmo com uma determinada expressão regular. Por exemplo, qualquer conteúdo da área de transferência iniciando com http:// pode ser passado para o Firefox ou o &konqueror; como uma &URL; a ser aberta. Adicionalmente, se o conteúdo corresponder a um caminho, ações similares podem ser realizadas de acordo com o tipo de arquivo. Por exemplo, se o caminho para um arquivo PDF for copiado para a área de transferência, o arquivo pode ser visualizado no &okular;.

Para usar este recurso, basta selecionar um &URL; ou caminho. Se existir uma correspondência com alguma expressão regular da lista do &klipper;, um menu aparecerá mostrando os programas disponíveis para sua seleção. Use o mouse ou teclado para selecionar um programa, e o &klipper; executará este programa, abrindo o endereço apontado pelo conteúdo da área de transferência.

Você pode alterar o tempo de exibição do menu nas configurações, com a opção Mostrar menu popup de ações na página Geral. Você pode desativar separadamente a parte do caminho do arquivo usando a opção Incluir ações MIME na página Menu de ações.

Ações podem ser desabilitadas completamente pressionando &Ctrl;&Alt;X.

O conteúdo da área de transferência que corresponde a uma expressão regular também pode ser editado antes de executar uma ação sobre ele. Selecione Editar conteúdo... à direita do item da área de transferência, para que possa mudar o seu conteúdo na caixa de diálogo que aparece, antes de clicar no botão OK para executar a ação correspondente.

Pressionar &Ctrl;&Alt;R mostra o menu para repetir a última ação que o &klipper; executou.

### Comportamento da Área de Transferência/Seleção

#### Geral

O &klipper; pode ser usado para configurar o comportamento da área de transferência e seleção no &plasma;.

O &X-Window; usa dois buffers separados de área de transferência: o de seleção e o da área de transferência. O texto é colocado no buffer de seleção simplesmente selecionando-o, e pode ser colado com o botão do meio do mouse. O texto deve ser explicitamente colocado no buffer da área de transferência selecionando-o e pressionado &Ctrl;X ou &Ctrl;C . O texto do buffer da área de transferência é colado usando o &Ctrl;V ou selecionando Colar no menu de contexto.

#### Mudando o Comportamento da Área de Transferência/Seleção

Para mudar o comportamento da área de transferência/seleção, selecione Configurar área de transferência... no menu de contexto, e na caixa de diálogo que aparecer, selecione a página Geral. Desmarcar Seleção e área de transferência faz com que as funções de área de transferência e seleção ocupem buffers distintos conforme descrito anteriormente. Com esta opção configurada, a opção Ignorar seleção evitará que o &klipper; inclua conteúdo da seleção no seu histórico da área de transferência e que ele execute ações sobre o conteúdo da seleção. Selecionar Seleção e área de transferência fará com que os buffers da área de transferência e seleção sejam sempre o mesmo, fazendo com que o texto na seleção possa ser colado tanto com o botão do meio do mouse ou a combinação de teclas &Ctrl;V , e da mesma maneira que o texto no buffer da área de transferência.

## Configurando o &klipper;

### Opções gerais

Seleção e área de transferência

- Quando um texto ou uma área da tela é selecionada com o mouse ou o teclado, essa é a seleção. Ela pode ser colada usando o botão do meio do mouse.

  Se a seleção for copiada explicitamente usando uma ação Copiar ou Recortar, ela será salva na área de transferência. Ela poderá ser colada usando uma ação Colar.

  Quando ativada, esta opção mantém a seleção e a área de transferência iguais, de modo que qualquer seleção esteja imediatamente disponível para colar por qualquer meio. Se estiver desativada, a seleção ainda poderá ser salva no histórico da área de transferência (sujeito às opções abaixo), mas só poderá ser colada usando o botão do meio do mouse.

Histórico da área de transferência

- Alterna o histórico da área de transferência.

Número de entradas

- Configura o número de itens que serão armazenados no histórico da área de transferência.

Seleção de texto

- Quando uma área da tela é selecionada com o mouse ou teclado, isso é chamado de seleção. Esta opção determina se as seleções de texto são salvas no histórico da área de transferência. É possível escolher entre Sempre salvar no histórico e Somente quando copiado explicitamente. A opção Sempre salvar no histórico não está disponível se a sincronização de seleção/área de transferência estiver desativada ‐ nesse caso, a seleção nunca é salva automaticamente no histórico da área de transferência. Consulte clipboard-modes.

Seleção não textual

- Esta opção determina se seleções que não sejam texto (como imagens) são salvas no histórico da área de transferência. É possível escolher entre Sempre salvar no histórico, Somente quando explicitamente copiado e Nunca salvar no histórico. A opção Sempre salvar no histórico não está disponível se a sincronização de seleção/área de transferência estiver desativada ‐ nesse caso, a seleção nunca é salva automaticamente no histórico da área de transferência. Consulte clipboard-modes.

### Menu de ações

Mostra menu de contexto de ações

- Configura o tempo que o menu das ações irá permanecer aberto, se você não selecionar nenhuma ação dele.

Repetir ações sobre um item selecionado do histórico

- Se esta opção estiver habilitada, selecionar um item do histórico fará com que o &klipper; exiba o menu de ações sobre este item, se necessário.

Remover espaços em branco ao executar as ações

- Se estiver selecionada, todos os caracteres em branco (espaços, tabulações, &etc;) no início e no fim do conteúdo da área de transferência serão removidos antes de passar o conteúdo da área de transferência para o aplicativo. Isto é útil, por exemplo, se a área de transferência contiver um &URL; com espaços que, ao ser aberto por um navegador Web, poderia causar um erro.

Incluir ações MIME

- Se selecionado, inclui aplicativos que possam aceitar o tipo &MIME; de um nome de arquivo ou URL selecionado no menu popup.

### Configuração das ações

Editando Expressões/Ações

- Na página de Ações, dê um duplo-clique numa expressão regular ou ação que deseja editar ou selecione-a e pressione o botão Editar ação. Um diálogo aparecerá no qual o texto da expressão pode ser editado conforme você desejar.

Adicionando Expressões/Ações

- Clique no botão Adicionar ação... para adicionar uma expressão regular para o &klipper; pesquisar. O &klipper; usa o `QRegularExpression` do &Qt;, que usa PCRE (Expressões Regulares Compatíveis com o Perl).

  Você pode adicionar uma descrição para o tipo da expressão regular (⪚ HTTP URL) através de um clique esquerdo na coluna Descrição.

  Você pode encontrar informações detalhadas sobre o uso de expressões regulares do `QRegularExpression` na documentação do Qt.

  Edita a expressão regular como descrito acima. Para adicionar o comando a ser executado, clique em Adicionar Comando e edite o comando na caixa de texto. Um duplo-clique no comando permitirá que você o edite.

  Observe que o %s na linha de comando é substituído pelo conteúdo da área de transferência, ⪚ se sua definição de comando é ``kwrite` %s` e o conteúdo da área de transferência é `/home/marcus/arquivotexto`, o comando ``kwrite` `/home/marcus/arquivotexto`` será executado. Para incluir o %s na linha de comando, escape-o com uma barra invertida, como a seguir: `\%s`.

  As entradas `%0` até `%9` serão substituídas pelos textos correspondentes capturados do padrão de correspondência.

### Opções de Atalhos

A página de atalhos permite mudar os atalhos de teclado que serão usado para acessar as funções do &klipper;. Você pode mudar o atalho para uma de três coisas:

Nenhum

- A ação selecionada não será acessada diretamente do teclado

Padrão

- A ação selecionada usa a tecla padrão do &klipper;. Estas teclas estão relacionadas neste manual.

Personalizado

- A ação selecionada será associada às teclas que você escolher.

  Para escolher uma tecla personalizada para ação que você selecionou, clique em Personalizado e então Nenhum. Agora digite a combinação desejada de teclas em seu teclado, como em qualquer aplicativo do &kde;.

Se definir um atalho para Abrir o Klipper na posição do mouse, ao pressionar este atalho irá abrir o menu de contexto do &klipper; na posição do ponteiro do mouse, em vez da sua posição padrão (no Painel do &plasma;). É útil se você usar mais o mouse do que o teclado.

## Créditos e licença

&klipper;

Programa copyright 1998 &Andrew.Stanley-Jones; asj@cban.com

Direito de cópia do programa de 1998-2000 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;

Mantido atualmente por Esben Mose Hansen. Veja em http://mosehansen.dk/about os detalhes de contato.

Direito de cópia de documentação de 2000-2003, 2005 &Philip.Rodrigues; &Philip.Rodrigues.mail;

Tradução de Marcus Gama marcus.gama@gmail.com e André Marcelo Alvarenga alvarenga@kde.org

&underFDL; &underGPL;
&documentation.index;