<commandImages>はオリジナル(デフォルト)アイコンと置き換わるShareazaコマンド用の新しいアイコンを提供します。
様々な新しいコマンドアイコンを指定することができますが、それぞれのサイズは16x16でなければなりません。.icoファイル(1つのファイルにつき 1つの画像)か、.bmp画像ファイル(一つのファイルに複数の画像を横に並べて配置しておく)を読み込むことができます。アイコンファイルは自動的に透過処理されますが、ビットマップファイルは透過色を指定しておく必要があります。デフォルトではこれはlight green(00FF00)ですが、他の色を指定することもできます。
A visual list of the default icons and their corresponding IDs can be found in Default.xml and Definitions.xml online.
以下はMyIconsSkin.xmlによる例です:
<?xml version="1.0" encoding="UTF-8"?> <skin xmlns="http://www.shareaza.com/schemas/Skin.xsd" version="1.0"> <manifest name="My Icons Skin" author="Me" type="Skin"/> <commandImages> <bitmap path="MyIcons.bmp" mask="00FF00"> <image id="ID_TAB_HOME"/> <image id="ID_TAB_LIBRARY"/> <image id="ID_TAB_NETWORK"/> <image id="ID_TAB_TRANSFERS"/> <image id="ID_TAB_CONNECT"/> </bitmap> <icon path="MyIcon.ico" id="ID_NETWORK_CONNECT"/> </commandImages> </skin> |
In the case of an icon, the target command where the icon is to be used is specified in the id attribute. For a list of command IDs, check out default-en.xml in your skins folder or consult the visual index of icons in Default.xml and Definitions.xml online.
ビットマップの場合は、複数のアイコンが同じ画像内に格納されています。それぞれのアイコンは1つ以上のコマンドに関連づけられていなければなりません。これはid属性を持つ<image>タグで行われます。
Advanced users may note that there is a second parameter named index which can be applied to the <image> tag, which specifies the index of the icon in the image file (0-based). Specific use of this attribute can be used to associate the same image index with several commands, thus avoiding duplication. For example:
<bitmap path="MyIcons.bmp" mask="00FF00"> <image id="ID_NETWORK_CONNECT" index="0"/> <image id="ID_NETWORK_DISCONNECT" index="0"/> <image id="ID_TAB_LIBRARY"/> </bitmap> |
In this example, ID_NETWORK_CONNECT and ID_NETWORK_DISCONNECT would both take on the first icon in the image. The second icon would be assigned to ID_TAB_LIBRARY.
