如何:将图标添加工具栏上的命令

命令可以出现在菜单和工具栏。 在工具栏上,它是常见的情况命令可以显示与图标 (节省空间),则在菜单命令通常显示与图标和文本时。

图标 16 个像素宽的高度约 16 像素,并且可以是 8 位颜色深度 (256 种颜色) 或 32 位颜色深度 (真彩色。) 32 位色图标首选方法。 图标在单个位图的唯一水平线通常被封送,不过,多个位图允许的。 该位图包含在 .vsct 文件中声明与单个的图标一起使用在位图。 为 Bitmaps 元素 有关更多详细信息参见参考。

将图标添加命令

将图标添加命令

  1. 在 32 位颜色深度创建位图。 图标始终为 16 x 16,因此该位图必须都为高度约 16 像素、 16 像素的多个。

    每个图标位图在紧挨着位于行。 使用 alpha 通道指示透明度在每个图标的。

    如果使用 8 位颜色深度,使用紫红色, RGB(255,0,255),作为透明度。 但是, 32 位色图标首选方法。

  2. 在编辑器中打开 .vsct 文件。

  3. Symbols 元素,找到包含现有的位图项的 GuidSymbol 元素 。 默认情况下,名为 guidImages

    下面的示例演示 Visual Studio 包模板生成的默认 <GuidSymbol> 元素。

    <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>
    
  4. 将每个图标的 IDSymbol 元素 在位图。 name 属性是图标的 ID,并且, value 指示其在条的位置。

  5. 创建 Bitmap 元素 在 .vsct 文件的 <Bitmaps> 部分指示包含该图标的位图。

    • 设置 guid 值设置为包含位图声明 <GuidSymbol> 元素的名称。

    • 设置 href 属性设置为位图文件的相对路径或设置 resID 属性设置为整数资源在其他地方,将包,引用所需的位图。

    • 您可以通过设置 usedList 特性增强性能。逗号分隔用于 VSPackage 的列表图标。 图标不在列表将排除的窗体生成。 必须指定 usedList,如果使用 resID 而不是 href。

    下面的示例演示包模板创建的默认项。

    <Bitmap guid="guidImages" href="Resources\Images_32bit.bmp" usedList="bmpPic1, bmpPic2, bmpPicSearch, bmpPicX, bmpPicArrows" />
    
  6. 创建 Button 元素Buttons 元素 或使用现有项。

    • 在 <Button> 元素中,添加 Icon 元素 并将其 guid 和 id 属性 GUID: ID 某个位图的图标。

    • 如有必要,请添加以下标志之一添加到按钮定义为 Command Flag 元素:

      IconAndText:图标和按钮文本在菜单和工具栏显示。

      Pict:,在命令的纯文本在菜单时,显示命令的图标只在显示工具栏。 如果图标未指定,一个空格工具栏上显示。

      TextOnly:命令的纯文本在工具栏或菜单显示。 <Icon> 元素将被忽略。

      有关标志的更多信息,请 CommandFlag 参见元素文档。

请参见

概念

VSCT XML 架构参考

其他资源

使用命令、菜单和工具栏的常规任务