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"/>
<button id="ID_NETWORK_CONNECT" text="Connect"/>
<button id="ID_NETWORK_SEARCH" text="New Search"/>
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 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 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 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 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.
For an up-to-date version of names see default-en.xml in your skins folder. Some of the current toolbar names are:
|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.|
|CSearchWnd.Full||The search window toolbar, in full screen mode.|
|CSearchWnd.Panel||The search window toolbar, with the search panel visible.|