How to: 將圖示新增至工具列上的命令
命令可以出現在功能表和工具列。 在 [工具列],它是很常見的命令通常會出現的圖示和文字顯示時帶有只是圖示 (若要節省空間) 時的功能表命令項目。
圖示是 16 個像素寬 x 高的 16 像素,並可為 8 位元色彩深度 (256 色) 或 32 位元色彩深度 (全彩)。 32 位元色彩圖示是慣用的。 雖然允許多個點陣圖,圖示通常會排列在單一的水平列,在單一的點陣圖。 這個點陣圖被宣告一起使用點陣圖中的個別圖示的.vsct 檔案中。 請參閱 < 參考的Bitmaps 項目如需詳細資訊。
將圖示新增到命令
若要將圖示加入至命令
32 位元色彩深度建立點陣圖。 圖示永遠是 16 x 16,所以這個點陣圖必須是 16 像素高度和寬度的 16 像素的倍數。
每個圖示都放在彼此的單一資料列的點陣圖。 用於表示數張投影片中的每個圖示的 alpha 色頻。
如果您使用 8 位元色彩深度,使用洋紅、 RGB(255,0,255),為透明。 然而,32 位元色彩圖示是慣用的。
在編輯器中開啟.vsct 檔案。
在Symbols 項目,找出GuidSymbol 項目包含現有的點陣圖的項目。 預設情況下,它稱為 guidImages。
下列範例會顯示預設的<GuidSymbol> Visual Studio 的封裝範本所產生的項目。
<GuidSymbol name="guidImages" value="{7f2b0178-a581-424f-933f-f6da41774269}"> <IDSymbol name="bmpPic1" value="1" /> <IDSymbol name="bmpPic2" value="2" /> <IDSymbol name="bmpPicSearch" value="3" /> <IDSymbol name="bmpPicX" value="4" /> <IDSymbol name="bmpPicArrows" value="5" /> </GuidSymbol>
新增IDSymbol 項目為您的點陣圖中的每個圖示。 name屬性是圖示的識別碼,以及value指出在該區域上的位置。
建立Bitmap 項目在<Bitmaps> .vsct 檔,來代表包含圖示的點陣圖的區段。
設定guid值的名稱<GuidSymbol>包含點陣圖宣告的項目。
設定href屬性設定為點陣圖檔案的相對路徑,或設定resID屬性設定為整數的資源,在套件中,指向您想要的點陣圖其他地方的設定。
您可以改善效能,藉由設定usedList屬性設定為以逗點分隔的清單在 VSPackage 中使用的圖示。 圖示不在清單就會排除表單編譯。 如果使用 resID href 代替,您必須指定 usedList。
下列範例會示範建立封裝範本的預設項目。
<Bitmap guid="guidImages" href="Resources\Images_32bit.bmp" usedList="bmpPic1, bmpPic2, bmpPicSearch, bmpPicX, bmpPicArrows" />
建立Button 項目在Buttons 項目 ,或使用現有的項目。
內部<Button>項目,加入Icon 項目 ,並設定其guid和id屬性的其中一項您點陣圖中的圖示 GUID:ID。
如有需要,加入下列其中一項旗標] 按鈕定義為CommandFlag 項目:
IconAndText: 同時圖示和按鈕文字會顯示在功能表和工具列。
Pict: 工具列上顯示只有命令的圖示,而顯示在功能表命令的文字。 如果未指定圖示,在空白區域會顯示在工具列上。
TextOnly: 只有命令的文字會顯示在工具列或功能表。 <Icon>項目會被忽略。
如需有關命令旗標的詳細資訊,請參閱 <CommandFlag> 項目的文件。