Skinning Tutorial

[ Back to Shareaza Skinning ]

<toolbars>

The <toolbars> element defines the toolbars used in the program. Shareaza contains many toolbars, and each of which is assigned a name to identify it. Skins can override the design for every toolbar, or just a few.

To see what the toolbars currently look like, check out default-en.xml in your skins folder.

Here is an example from 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>

Each toolbar is contained within a <toolbar> element, which is named by a name attribute. A list of current toolbar names is included at the end of this section. Each toolbar contains one or more items, which can be <button>'s, <separator>'s, <control>'s or <label>'s. Each is explained below:

Buttons
Buttons are created with a <button/> element, and are the most common item found on toolbars. Each button has the following attributes:

  • id - The command ID of the button, which controls what it actually does.
  • text - The optional text to display next to the icon. If left out, no text is displayed.
  • colour - The optional colour in which to draw the button eg (0000FF).
  • tip - An optional tooltip to display for this button, which overrides the normal tooltip for the target command.

Separators
Separators are created with a <separator/> element, and are the second most common item found on toolbars. Separators have no additional attributes, as they simply produce a "gap" in the toolbar, often used to group sets of buttons together.

Controls
Controls are created with a <control/> element. They allow the inclusion of an input control within the context of the toolbar, at a specific position. Controls have an id attribute which identifies the control code, and a width attribute which specifies the pixel width of the control. At this time it is not possible to create new controls on toolbars, but it is possible to position and resize existing ones using this method.

Labels
Labels are created with a <label/> element, and appear as static text on the toolbar which cannot be clicked. Labels have two attributes, text and tip which specify the text to display on the label, and the mouse-over tooltip to show respectively.

Toolbar Names
For an up-to-date version of names see default-en.xml in your skins folder. Some of the current toolbar names are:

Toolbar Description
CBrowseHeaderCtrl
CBrowseHostWnd
CBrowseHostWnd.Basic
CBrowseTree.Top
CDownloadsWnd
CDownloadsWnd.Basic
CHitMonitorWnd
CHostCacheWnd
CHostCacheWnd.Basic
CLibraryCollectionView.Virtual
CLibraryFileView.Physical
CLibraryFileView.Physical.Basic
CLibraryFileView.Virtual
CLibraryFileView.Virtual.Basic
CLibraryHeaderBar.Physical
CLibraryHeaderBar.Virtual
CLibraryHomeView.Physical
CLibraryHomeView.Virtual
CLibraryTileView.Virtual
CLibraryTree.Top
CLibraryTree.Virtual
CLibraryWnd.Files The library window's file toolbar.
CLibraryWnd.Folders The library window's folder toolbar.
CMainWnd.Basic The main window toolbar, in normal mode.
CMainWnd.Tabbed The main window toolbar, in tabbed mode.
CMainWnd.Windowed The main window toolbar, in windowed mode.
CMediaFrame
CMediaFrame.Basic
CMediaList
CNeighboursWnd
CNeighboursWnd.Basic
CPrivateChatFrame
CSearchWnd.Full The search window toolbar, in full screen mode.
CSearchWnd.Panel The search window toolbar, with the search panel visible.
CSearchWnd.Panel.Basic
CUploadsWnd
CUploadsWnd.Basic

[ Back to Shareaza Skinning ]

  • en
  • es
  • fr
  • de
  • hr
  • it
  • lt
  • nl
  • nb
  • pl
  • pt
  • sl
  • tr
  • el
  • he
  • ja
  • zh-tw
  • en
  • ca
  • fa
  • ru
Many people contribute their time and effort to Shareaza. Please see our acknowledgements page.
Visit Shareaza's Project Page at SourceForge.net

SourceForge.net Logo
< Top of the Page | Contact Us >