メニュー コマンドにアイコンを追加する
コマンドは、メニューとツール バーの両方に表示できます。 ツール バーでは、コマンドをアイコンだけで表示する (領域を節約するため) ことが一般的であるのに対して、メニューでは、コマンドは通常、アイコンとテキストの両方で表示されます。
アイコンは幅が 16 ピクセル、高さが 16 ピクセルであり、8 ビットの色深度 (256 色) または 32 ビットの色深度 (トゥルー カラー) のどちらにもできます。 32 ビット カラー アイコンが推奨されます。 アイコンは通常、1 つのビットマップ内で水平方向の 1 行に配置されますが、複数のビットマップも許可されます。 このビットマップは、そのビットマップで使用可能な個々のアイコンと共に .vsct ファイルで宣言されます。 詳細については、「Bitmaps 要素」のリファレンスを参照してください。
コマンドにアイコンを追加する
次の手順では、メニュー コマンドを含む既存の VSPackage プロジェクトがあることを前提にしています。 これを行う方法を見つけるには、「メニュー コマンドを使用して拡張機能を作成する」を参照してください。
色深度が 32 ビットのビットマップを作成します。 アイコンは常に 16 x 16 であるため、このビットマップは高さが 16 ピクセル、幅が 16 ピクセルの倍数である必要があります。
各アイコンは、ビットマップ上で 1 行内に互いに横に並べて配置されます。 各アイコン内の透明度の場所を示すには、アルファ チャネルを使用します。
8 ビットの色深度を使用する場合は、マゼンタ
RGB(255,0,255)を透明度として使用します。 ただし、32 ビット カラー アイコンが推奨されます。アイコン ファイルを VSPackage プロジェクト内の Resources ディレクトリにコピーします。 ソリューション エクスプローラーで、プロジェクトにアイコンを追加します。 (Resources を選択し、コンテキスト メニューの [追加]、[既存項目] の順にクリックして、アイコン ファイルを選択します)。
エディターで .vsct ファイルを開きます。
testIcon の名前を持つ
GuidSymbol要素を追加します。 GUID を作成し ([ツール]>[GUID の作成] の順に選択し、[レジストリ形式] を選択して [コピー] をクリックします)、それをvalue属性に貼り付けます。 結果は次のようになります。<!-- Create your own GUID --> <GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}">アイコンの
<IDSymbol>を追加します。name属性はアイコンの ID であり、valueはストリップ上のその位置を示します (存在する場合)。 アイコンが 1 つしかない場合は、1 を追加します。 結果は次のようになります。<!-- Create your own GUID --> <GuidSymbol name="testIcon" value="{00000000-0000-0000-0000-0000}"> <IDSymbol name="testIcon1" value="1" /> </GuidSymbol><Bitmap>.vsct ファイルの<Bitmaps>セクション内<Commands>に、アイコンを含むビットマップを表すセクションを作成します。guid値を、前の手順で作成した<GuidSymbol>要素の名前に設定します。href値をビットマップ ファイルの相対パス (この場合は、Resources\<アイコン ファイル名> に設定します。usedList値を、前に作成した IDSymbol に設定します。 この属性では、VSPackage で使用されるアイコンのコンマ区切りリストを指定します。 このリストにないアイコンは、コンパイルから除外されます。Bitmap ブロックは次のようになります。
<Bitmap guid="testIcon" href="Resources\<icon file name>" usedList="testIcon1"/>
既存の
<Button>要素で、Icon要素を、前に作成した GUIDSymbol と IDSymbol の値に設定します。 これらの値を持つ Button 要素の例を次に示します。<Button guid="guidAddIconCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button"> <Parent guid="guidAddIconCmdSet" id="MyMenuGroup" /> <Icon guid="testIcon" id="testIcon1" /> <Strings> <ButtonText>My Command name</ButtonText> </Strings> </Button>アイコンをテストします。 プロジェクトをビルドし、デバッグを開始します。 実験用インスタンスで、コマンドを見つけます。 そこには、追加したアイコンが表示されます。