BITMAPS_BEGIN-BITMAPS_END
[このドキュメントはプレビュー版であり、後のリリースで変更されることがあります。 空白のトピックは、プレースホルダーとして挿入されています。]
The BITMAPS_BEGIN – BITMAPS_END section is used to make custom icons available to the commands that are defined in the BUTTONS_BEGIN-BUTTONS_END section.
注意
Visual Studio SDK には、標準のアイコンの一連も用意されています。These icons are always available to commands and do not have to be defined in the BITMAPS_BEGIN – BITMAPS_END section.
For more information about how to use icons with commands, see BUTTONS_BEGIN-BUTTONS_END.
ビットマップ エントリ
An entry in the BITMAPS_BEGIN – BITMAPS_END section specifies a bitmap resource followed by one or more indexes to that bitmap for each icon. インデックスの参照はコンマで区切られます終わります、全体のエントリはセミコロンで。 次に、この構文を示します。ビットマップ ID アイコン インデックス アイコン インデックス、アイコンのインデックス。
これらのフィールドは、次の表で定義されています。 表示される順序のエントリに表示されますする必要があります。 セミコロン (;)、最後のアイコンのインデックス フィールドの後にする必要がありますです。 詳細については、"The ビットマップ エントリ フィールド] を参照してください。 ここ。
フィールド |
説明 |
|---|---|
Bitmap ID |
ビットマップを識別する GUID:ID ペアを指定します。 ID はビットマップのリソース ID です。 |
Icon Index |
インデックスが 1 から開始し、ビットマップのアイコンを指定します。 すべてのアイコンが同じ 16 ピクセル幅です。 1 つまたは複数のインデックス値を 1 つのビットマップを指定できます。 アイコン、ビットマップのエントリで指定した明示的に場合にのみはで使用できます、コマンド エントリ。 |
ビットマップの使用例 (VB)
The following code example shows the BITMAPS_BEGIN – BITMAPS_END section from the File Explorer sample. 次の使用例のエントリは読みやすくするためにインデントします。 実際、エントリにすべてのフィールドは、1 行にあります。 詳細については、「CMDS_SECTION-CMDS_END」を参照してください。
BITMAPS_BEGIN
guidEUGrp:IDB_CMDBAR,
bmpidFileSysTool, bmpidFolderView, bmpidShortcutView,
bmpidRefresh, bmpidOpenFile, bmpidPreviewFile, bmpidAddShortcut,
bmpidDeleteShortcut, bmpidExplorer, bmpidMSDOS, bmpidCommand;
BITMAPS_END
ビットマップ入力フィールド
Every entry in the BITMAPS_BEGIN – BITMAPS_END section must contain at least two fields, but multiple Icon Index fields are possible. コンマ エントリのすべてのフィールドを区切るし、セミコロン (;) をエントリの末尾を示します。 順のフィールドは次のとおりです。
Bitmap ID
Bitmap ID 識別リソースをビットマップの配列が含まれています。 Bitmap ID は、ID は、ビットマップ、VSPackage のリソース ファイル内でのリソース ID を GUID:ID のペアを常にです。
ビットマップの各リソース必要な一意の Bitmap ID です。 ビットマップのエントリを別のビットマップ エントリと、GUID を共有できますが各エントリ、固有のリソース ID でなければなりません GUID が通常の VSPackage のコマンド セット GUID が各ビットマップの具体的に作成される GUID は可能性があります。
ビットマップを作成する場合サテライト DLL を作成またはパッケージのマネージ リソース ファイルでリソース ID を定義する必要があります。 詳細については、"作成カスタム ビットマップ アイコン"を参照してください。 ここ。
Visual Studio、Microsoft Office、または Windows に含まれている、ビットマップ ファイルは、ビットマップ リソースとして使用できます。 たとえば、Office アイコンは Vsshlids.h で定義されている GUID guidOfficeIcon を使用して参照されます。 Vsshlids.h は Visual Studio SDK インストール パス \VisualStudioIntegration\common\inc\ にあります。
使用例には、Bitmap ID フィールドは以下のとおりです。
guidEUGrp:IDB_CMDBARこの例では、VSPackage のリソース (.rc) ファイルにリソース ID IDB_CMDBAR がビットマップ リソース含まれてする必要があります。
Icon Index
Icon Index フィールドを指定しますビットマップ リソースにするビットマップが使用されます。 Icon Index は の n、1 値 1 がビットマップの最初のイメージを表しますです。
The BUTTONS_BEGIN-BUTTONS_END section uses the Icon Index and the GUID of the Bitmap ID field to define a command Icon ID:GUID:Icon Index. インデックスには、実績数値値をインデックスまたはインデックス番号に割り当てられているマクロができます。 さらに読みやすいため、後者の規則を使用することをお勧めします。 たとえば、File Explorer サンプルでは、 Icon Index、 bmpidFileSysTool は定義されてとおりサンプル.ctc ファイルに含まれるが Pkgcmdid.h ヘッダー ファイルで。
#define bmpidFileSysTool 1使用例には、Icon Index フィールドの最初の 3 つの値次のとおりです。
bmpidFileSysTool, bmpidFolderView, bmpidShortcutView次のように、bmpidFolderView のビットマップを使用するコマンドは定義でした。
guidEUCmd:cmdidFolderView, guidEUGrp:IDG_FOLDERPANE_VIEW, 0x0010, guidEUGrp:bmpidFolderView, BUTTON, 0, "Folders";
カスタム ビットマップ アイコンを作成します。
Visual Studio SDK では、ように、プロジェクトのリソース ファイルを使用してカスタム アイコンを作成できます。
ビットマップ リソースごとに.rc ファイルで定義されている一意のリソース ID と必要です。
GUID をできる、ビットマップ リソースごとに定義されてか、VSPackage のコマンド セット GUID を使用できます。
この GUID: リソース ID のペア識別するために使用されます BITMAPS_BEGIN - BITMAPS_END セクションで、ビットマップです。 コマンド テーブル構成 (.Ctc) ファイル でのこの GUID を定義または.h のヘッダー ファイルには、.ctc ファイルに含まれます。
ビットマップ リソース内の各アイコンする必要があります 16 ピクセルと 16 ピクセル、し、背景色する必要がありますに設定マゼンタ、RGB(255,0,255.) によって定義されました。(32 ビットのイメージを使って、アルファ チャネルを指定透過性。)
作成されるアイコンは、Icon Index、1 から開始) が割り当てられます。
このビットマップの最初のアイコンは、GuidMyBmp:1 として指定できます。
メニューとツールバーに表示されるコマンドのアイコン、高い色 format は、アルファ チャネルによって透過性提供される 32 ビット ARGB になければなりません。 ツール ウィンドウのアイコン、高い色形式が 24 ビット (RGB)、および、透明な色コードで指定されたがあり、通常は RGB (255、0、255)。
読みやすくするためで #define ディレクティブを使用して、ヘッダー ファイルでそれぞれ Icon Index の人間が判読できる名前を入力します。 たとえば、File Explorer サンプルでは、 bmpidFileSysTool は定義されてサンプル.ctc ファイルに含まれるが Pkgcmdid.h ヘッダー ファイルで。
#define bmpidFileSysTool 1