Skinning.toolbars

From Shareaza Wiki
Revision as of 21:19, 17 August 2009 by Ocexyz (talk | contribs) (added recovered 2nd level content Skinning.toolbars - Verification needed!)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
  Languages:

[[::Skinning.toolbars|English]] • [[::Skinning.toolbars/de|Deutsch]] • [[::Skinning.toolbars/es|Español]] • [[::Skinning.toolbars/fr|Français]] • [[::Skinning.toolbars/he|עברית]] • [[::Skinning.toolbars/it|Italiano]] • [[::Skinning.toolbars/nl|Nederlands]] • [[::Skinning.toolbars/pl|Polski]] • [[::Skinning.toolbars/pt|Português]] • [[::Skinning.toolbars/ru|Русский]] • [[::Skinning.toolbars/zh-hant|‪中文(繁體)]]

e
  Recovered

The following content has been recovered from the old wiki and pantheraproject*net. Competent verification is needed.

e

<a name=".3Ctoolbars.3E" id=".3Ctoolbars.3E"></a>

<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:

 <span class="sc3"><span class="re1"><?xml</span> <span class="re0">version</span>=<span class="st0">"1.0"</span> <span class="re0">encoding</span>=<span class="st0">"UTF-8"</span><span class="re2">?></span></span>
 <span class="sc3"><span class="re1"><skin</span> <span class="re0">xmlns</span>=<span class="st0">"http://www.shareaza.com/schemas/Skin.xsd"</span> <span class="re0">version</span>=<span class="st0">"1.0"</span><span class="re2">></span></span>
 <span class="sc3"><span class="re1"><manifest</span> <span class="re0">name</span>=<span class="st0">"My Toolbar Skin"</span> <span class="re0">author</span>=<span class="st0">"Me"</span> <span class="re0">type</span>=<span class="st0">"Skin"</span><span class="re2">/></span></span>
 <span class="sc3"><span class="re1"><toolbars<span class="re2">></span></span></span>
  <span class="sc3"><span class="re1"><toolbar</span> <span class="re0">name</span>=<span class="st0">"CMainWnd.Tabbed"</span><span class="re2">></span></span>
   <span class="sc3"><span class="re1"><button</span> <span class="re0">id</span>=<span class="st0">"ID_NETWORK_CONNECT"</span> <span class="re0">text</span>=<span class="st0">"Connect"</span><span class="re2">/></span></span>
   <span class="sc3"><span class="re1"><button</span> <span class="re0">id</span>=<span class="st0">"ID_NETWORK_DISCONNECT"</span><span class="re2">/></span></span>
   <span class="sc3"><span class="re1"><separator</span><span class="re2">/></span></span>
   <span class="sc3"><span class="re1"><button</span> <span class="re0">id</span>=<span class="st0">"ID_NETWORK_SEARCH"</span> <span class="re0">text</span>=<span class="st0">"New Search"</span><span class="re2">/></span></span>
  <span class="sc3"><span class="re1"></toolbar<span class="re2">></span></span></span>
 <span class="sc3"><span class="re1"></toolbars<span class="re2">></span></span></span>
 <span class="sc3"><span class="re1"></skin<span class="re2">></span></span></span>

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:

<a name="Buttons" id="Buttons"></a>

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.

<a name="Separators" id="Separators"></a>

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.

<a name="Controls" id="Controls"></a>

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.

<a name="Labels" id="Labels"></a>

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.

<a name="Toolbar_Names" id="Toolbar_Names"></a>

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