[ Voltar a Skinning do Shareaza ]

O elemento <toolbars> define a barra de ferramenta usada no programa. Shareaza contém muitas barras de ferramentas, e a cada uma das quais é atribuída um nome para identificá-la. Skins pode substituir o design para cada barra de ferramentas, ou apenas alguns.

Para ver com o que as barras de ferramentas atualmente se parecem, confira default--pt-br.xml na sua pasta de skins.

Aqui está um exemplo de MyToolbarSkin.xml:

<?xml version="1.0" encoding="UTF-8"?>

<skin xmlns="http://www.shareaza.com/schemas/Skin.xsd" version="1.0">

<manifest name="My Toolbar Skin" author="Me" type="Skin"/>

<toolbars>

   <toolbar name="CMainWnd.Tabbed">

      <button id="ID_NETWORK_CONNECT" text="Connect"/>

      <button id="ID_NETWORK_DISCONNECT"/>

      <separator/>

      <button id="ID_NETWORK_SEARCH" text="New Search"/>

   </toolbar>

</toolbars>

</skin>

Cada barra de ferramentas está contida dentro de um elemento <toolbar> , o qual é nomeado por um atributo nome. Uma lista de nomes da barra de ferramentas atual está incluída no fim desta seção. Cada barra de ferramentas contém um ou mais itens, os quais podem ser <button>'s, <Separator>, <control>'s ou <label>' s. Cada um é explicado abaixo:

Botões
Botões são criados com um elemento <button/> , e são o item mais comum achado nas barras de ferramentas. Cada botão tem os seguintes atributos:

• id - A ID do comando do botão, o qual controla o que ele realmente faz.
• text - O texto opcional para exibir ao lado do ícone. Se deixado de fora, nenhum texto é exibido.
• colour - A cor opcional na qual desenhar o botão eg (0000FF).
• tip - Uma dica opcional para mostrar para esse botão, que substitui a dica normal para o comando-alvo.

Separadores
Separadores são criados com um elemento <separator/> , e são o segundo item mais comum achado nas barra de ferramentas. Os separadores não tem atributos adicionais, como eles simplesmente produzem um "gap" na barra de ferramentas, frequentemente usado para agrupar definições de botões juntos.

Controles
Os controles são criados com um elemento <control/>. Eles permitem a inclusão de um controle de entrada dentro do contexto da barra de ferramentas, em uma posição específica. Controles tem um atributo id o qual identifica o código de controle, e um atributo width (largura) o qual especifica a largura do pixel do controle. Neste momento não é possível criar novos controles nas barras de ferramentas, mas é possível posicionar e redimensionar as existentes usando este método.

Rótulos
Rótulos são criados com um elemento <label/> , e aparecem como um texto estático na barra de ferramentas a qual não pode ser clicada. Rótulos tem dois atributos texto e dicas as quais especificam o texto a exibir no rótulo, e a dica de ferramenta com o mouse sobre algo a mostrar respectivamente.

Nomes da Barras de Ferramentas
Para uma versão atualizada dos nomes ver deault-en.xml na sua pasta de skins. Alguns dos nomes das barra de ferramentas atuais são: