# Manual do Painel K

O Time KDE
06/05/1998
0.19.01

Esta documentação foi atualizada pela última vez para a versão 0.19.1 do kpanel.

KDE
KPanel
control panel

## Introdução

O kpanel ajuda você a iniciar e gerenciar suas aplicações e ambientes de trabalho virtuais no KDE. Ele provê acesso rápido a uma série de objetos, dentre eles:

- o Iniciar Aplicação do KDE

- uma barra de tarefas com as aplicações em uso no momento

- botões para iniciar facilmente aplicações freqüentemente utilizadas

- ambientes de trabalho virtuais

O kpanel é muito flexível e altamente configurável, e oferece opções gerais do sistema bem como opções personalizadas do usuário. Este documento descreve como configurar e utilizar o kpanel.

### Recursos

Os recursos oferecidos pelo kpanel incluem:

- painel e barra de tarefas posicionáveis de forma independente;

- painel e barra de tarefas têm capacidade de ocultar-se automaticamente;

- "dicas" configuráveis;

- possibilidade de executar pequenas aplicações de notificação e status dentro do próprio painel;

- possibilidade de definir múltiplos ícones para um botão do Painel, e comutar entre eles utilizando os comandos do kpanel.

## Fundamentos

O kpanel mostra duas janelas: a barra de tarefas e o painel.

- A barra de tarefas mostra as aplicações em execução no momento;

- P painel contém o botão Iniciar; um botão para mostrar a lista de janelas; os botões dos ambientes de trabalho virtuais; e botões para aplicações freqüentemente utilizadas.

O painel e a barra de tarefas podem ser posicionados independentemente um do outro.

### Barra de tarefas

A barra de tarefas mostra uma lista das aplicações em execução. Os títulos das janelas que estão iconificadas são mostrados entre parênteses. Clicar um item da lista move o foco para a aplicação selecionada, e inclusive muda o ambiente de trabalho virtual se for necessário.

Você também pode clicar qualquer item da barra de tarefas com o botão direito do mouse, e escolher uma das opções: maximizar, iconificar, fechar ou mover a aplicação para o ambiente de trabalho atual.

### Painel

O painel aparece por padrão na parte inferior da tela. Ele contém o botão Iniciar, um relógio, e botões para os ambientes de trabalho e para as aplicações comumente utilizadas. Você pode livrar-se do painel clicando na barra texturizada na extremidade esquerda do painel. Isso remove o painel do ambiente de trabalho atual, mas não dos demais. Você também pode configurá-lo para que ele oculte-se sozinho. Nesse caso ele ficará escondido até que você encoste o ponteiro do mouse no lado da tela em que o Painel "mora" (por padrão é no lado inferior).

Segue uma explicação dos ícones que aparecem no painel padrão:

Iniciar Aplicação

  Clicar o grande K no painel abre um menu de aplicações e utilitários. Também provê acesso à ajuda do sistema e ao Painel de Controle do KDE. Você pode adicionar seus próprios itens.

  Atalho: `Alt-F1` tem o mesmo efeito do botão Iniciar;

Lista de Janelas

  Clicar o botão que tem a aparência de um grupo de janelas abre um menu, que mostra as aplicações abertas no momento, organizadas por ambiente de trabalho. Títulos entre parênteses indicam janelas iconificadas. Selecione a aplicação para acessá-la.

  Atalho: clique o botão central do mouse em algum ponto vazio do ambiente de trabalho para mostrar a Lista de Janelas;

Diretório Base

  O botão com o desenho de uma casa provê acesso rápido aos arquivos em seu diretório-base (N.T.: a tradução literal de "home directory" é "diretório-casa", daí o desenho do ícone);

Ambientes de trabalho virtuais

  Os botões no centro do painel, por padrão identificados por "Um", "Dois", etc. dão acesso aos ambientes de trabalho virtuais. O número de ambientes e seus nomes podem ser mudados;

Navegador de Ajuda

  O botão como o desenho de um livro fornece acesso ao sistema de ajuda on-line do KDE.

Além dos botões padrão, você pode adicionar seus próprios botões para executar programas de uso freqüente. Além disso, os programas podem ser configurados para executarem diretamente no painel. Por exemplo, você pode definir um botão que mostra um programa de notificação de e-mail no painel, e que além disso executa um programa de leitura de e-mails quando pressionado.

## Configurando o Painel

O kpanel é um componente altamente flexível e configurável da interface de usuário do KDE. Esta seção contém instruções para ajudá-lo a customizá-lo a seu gosto. Para informação sobre o kpanelrc, que é o arquivo de configuração do kpanel, veja a seção Guia do Desenvolvedor.

Estão listadas abaixo instruções para configurar

- Posição e Comportamento do Painel;

- Botões do Painel;

- Ambientes de Trabalho Virtuais;

- Botão Iniciar.

### Posição e Comportamento do Painel

Para configurar a posição e o comportamento do Painel, clique o painel com o botão direito do mouse em algum espaço sem ícones, e escolha Configurar no menu. Clique o botão Ajuda para informações específicas de cada item.

### Botões do Painel

Você pode mover, excluir ou mudar as propriedades de um botão do painel; basta clicar o seu ícone com o botão direito, e escolher a opção desejada no menu de contexto.

Para adicionar um botão ao painel, utilize um dos três métodos a seguir:

- Para colocar um botão de lista de janelas no painel, escolha botão Iniciar > Painel > Adicionar Lista de Janelas;

- Para colocar no painel uma aplicação que já esteja presente no menu Iniciar, escolha Iniciar > Painel > Adicionar Aplicação, e continue a navegar pelo menu para selecionar a aplicação desejada. Você também pode colocar um submenu do menu Iniciar diretamente no painel utilizando o mesmo procedimento; quando você entrar no submenu desejado, selecione a primeira opção, que é o próprio submenu. Por exemplo, para colocar o submenu Configuração no painel, escolha Iniciar > Painel > Adicionar Aplicação > Configuração > Configuração;

- Arraste um ícone de uma janela kfm ou do ambiente de trabalho para o painel. Só podem ser arrastados ao painel: arquivos .kdelnk e pastas que contenham arquivos .kdelnk. Uma vez você tenha colocado um ícone no painel, clique o seu ícone com o botão direito e escolha Propriedades no menu para configurá-lo. Nota: Quando você coloca um ícone no painel dessa maneira, tenha o cuidado de não mover ou apagar o arquivo ou pasta .kdelnk original, sob pena do painel não poder mais exibir o ícone.

Dicas: O kpanel mostra dicas para os botões do painel e para os itens do menu Iniciar. Para configurar a dica de um botão, clique-o com o botão direito e escolha Propriedades do menu. Clique a aba "Aplicação" e preencha o campo Comentário com o texto da dica. Você pode precisar reiniciar o kpanel para que as mudanças surtam efeito (clique o painel com o botão direito e escolha Reiniciar).

Engolir Aplicação: Na aba "Executar" das propriedades de um ícone Aplicação, as configurações "Engolir no painel" permitem a você tem um botão no painel que mostra uma aplicação em funcionamento ao invés de um ícone estático. Isso é especialmente útil para pequenos aplicativos de notificação ou status como o xbiff. Eis como fazer:

- Preencha o campo Executar com o nome da aplicação a ser executada dentro do painel. Note que esta é a configuração Executar na aba "Engolir no painel";

- Preencha o Título da Janela com o título da janela aberta pela aplicação quando é executada normalmente no ambiente de trabalho. O kpanel usa esse título para identificar que janela trazer para dentro do painel. Se a janela não tem uma barra de título, execute a aplicação e veja seu nome na barra de tarefas; use esse nome como título.

### Ambientes de Trabalho Virtuais

Para mudar os nomes dos botões dos ambientes de trabalho no painel, ou mudar o número de ambientes, clique o painel com o botão direito em alguma área sem ícones, e escolha Configurar no menu. Clique a aba Ambientes de Trabalho na janela de configuração do KPanel e faça as mudanças desejadas. Clique Ajuda para informação específica sobre as configurações.

### Menu Iniciar Aplicação

Para customizar a seção de usuário do menu Iniciar, escolha Iniciar > Painel > Editar Menus. Siga as instruções do utilitário kmenuedit para levar a cabo a configuração.

Para fazer com que suas escolhas específicas sejam as primeiras opções do menu, clique o painel com o botão direito em algum ponto sem ícones, e escolha Configurar no menu. Clique na aba "Opções" e selecione a opção "Pessoal Primeiro".

## Guia do Desenvolvedor

Esta seção cobre tópicos de interesse dos usuários avançados e desenvolvedores. São eles:

- Comandos do kpanel

- Arquivo de Configuração kpanelrc

### Comandos do kpanel

Você pode mandar comandos ao kpanel via Gerenciador de Janelas K utilizando qualquer uma das duas técnicas:

`KWM::sendKWMCommand(QString)` (dentro de aplicações KDE) or `kwmcom` comando (da linha de comando)

O kpanel responde aos seguintes comandos:

- kpanel:restart reinicia o painel, e recarrega seus arquivos de configuração;

- kpanel:hide Esconde o painel no ambiente de trabalho atual, como se o usuário tivesse clicado a pequena barra texturizada na extremidade esquerda do painel;

- kpanel:show mostra o painel se ele estava escondido;

- kpanel:system abre o menu Iniciar;

- kpanel:goXXXXYYYY abre o menu Iniciar numa localização específica da tela. Por exemplo, `kpanel:go05000100` abre o menu nas coordenadas (500,100);

- kpanel:icon:n:botão muda o ícone mostrado pelo botão no painel; onde n pode ser igual a 1, 2, 3 ou 4. Refere-se aos ícones definidos para o botão no arquivo .kdelnk do mesmo (linhas na forma canônica icon=pixmap, icon2=pixmap, etc.).

### kpanelrc

O kpanel pode ser configurado utilizando-se o Centro de Controle KDE (Iniciar > Centro de Controle KDE). Escolha Painel na seção Aplicações para trabalhar com as várias opções de configuração.

Para aqueles que preferem editar um arquivo de configuração, este segmento descreve as opções do arquivo kpanelrc, localizado em (diretório-base do usuário)/.kde/share/config.

A configuração do arquivo kpanelrc é dividido em duas seções:

- kpanel;

- kpanelButtons.

#### &lsqb;kpanel&rsqb;

A seção kpanel contém várias linhas que governam o comportamento de kpanel.

- AutoHide=`on&verbar;off` Quando igual a `on`, o painel esconde-se automaticamente logo que o usuário move o ponteiro do mouse para fora da sua área.

- AutoHideTaskbar=`on&verbar;off` Quando igual a `on`, a barra de tarefas esconde-se automaticamente logo que o usuário move o ponteiro do mouse para fora da sua área.

- BackgroundTexture=pixmap Mostra o pixmap (arquivo de imagem) como desenho de fundo do painel.

- BoxHeight=valor (em pixels) BoxWidth=valor (em pixels) Estas configurações determinam a altura do painel e a largura dos botões no painel, respectivamente.

- ClockAmPm=`on&verbar;off` Quando igual a `on`, o relógio do painel mostra a hora em formato 12 horas, AM/PM (estilo americano). Quando igual a `off`, o relógio mostra a hora em formato 24 horas (estilo europeu ou militar).

- DateFont=letra Determina o tipo de letra para o relógio do painel. Informe um especificador de fonte X, como `*-times-medium-i-normal--12-*`.

- DateVisible=`true&verbar;false` Se igual a `false`, esconde o relógio do painel.

- DesktopButtonFont=letra Especifica o tipo de letra para os botões de ambientes de trabalho virtuais do painel.

- DesktopButtonHorizontalSize=valor Especifica a largura dos botões de ambientes de trabalho virtuais. O parâmetro valor não é largura em pixels; para chegar à largura em pixels, o sistema multiplica esse parâmetro pela metade de `BoxWidth`.

- DesktopButtonRows=valor Especifica o número de linhas formadas pelos botões de ambientes de trabalho no painel.

- FoldersFirst=`on&verbar;off` Quando igual a `on`, submenus do menu Iniciar sempre aparecem no topo. Quando `off`, todos os itens aparecem em ordem alfabética.

- Margin=valor (in pixels) Este valor especifica o tamanho da borda superior e inferior do painel.

- MenuToolTips=valor (em milissegundos) Especifica quanto tempo o usuário precisa manter o mouse sobre um item no menu Iniciar para que a sua dica apareça.

- PanelHidden=00000000 Essa configuração especifica em que ambientes de trabalho o painel estará escondido. Há 8 dígitos no parâmetro, que correspondem à 8 ambientes. O dígito 0 (zero) na posição indica que o painel será visível no ambiente de trabalho correspondente; o dígito 1 (um), que o painel ficará oculto. Por exemplo, um parâmetro 01011000 esconde o painel nos ambientes de trabalho 2, 4 e 5.

- PersonalFirst=`on&verbar;off` Quando igual a `on`, as opções pessoais do usuário aparecem por primeiro no menu Iniciar. Quando `off`, as opções padrão do KDE é que aparecem por primeiro.

- Position=`bottom&verbar;top&verbar;left&verbar;right` Especifica a posição do painel na tela.

- Style=normal&verbar;tiny&verbar;large Especifica o estilo do painel. É usado pelo utilitário gráfico de configuração do kpanel kcmpanel e não afeta diretamente a aparência do painel.

- TaskbarButtonHorizontalSize=valor Um número inteiro que especifica a largura da barra de tarefas.

- TaskbarPosition=`top&verbar;top&lowbar;left&verbar;bottom&verbar;hidden` Especifica a posição da barra de tarefas na tela. Se igual a `hidden`, a barra de tarefas ficará escondida.

#### &lsqb;kpanelButtons&rsqb;

Esta seção especifica o posicionamento dos botões do painel.

- Buttons=botão1, botão2, ... Uma lista dos botões do painel, onde botão&num; pode ser `system` (o botão Iniciar), `windowlist` (a lista de janelas), ou o caminho completo de um arquivo .kdelnk.

- ButtonDelta=delta1, delta2, ... Especifica as posições dos botões no painel. Os deltas são valores de ponto flutuante, e para cada botão, representam a distância até o botão imediatamente à esquerda / acima.

- control=valor Especifica a que botão sucederá o bloco dos botões de ambientes virtuais. Se 0, o bloco vem logo após o botão K; se 1, o bloco aparece depois do primeiro botão após o botão K, e assim por diante.

- controldelta=delta Especifica a distância do bloco dos botões de ambientes virtuais, do botão imediatamente à esquerda / acima.

## Créditos

### Desenvolvimento

`Matthias Ettrich` - Developer

### Autores

`Stephen Schaub` - Autor

`Robert Williams` - editor SGML

`Elvis Pfutzenreuter` - tradução para Português-BR