Skinning.toolbars
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 |