图像服务和目录

  • 项目

本指南包含采用 Visual Studio 2015 中引入的 Visual Studio 图像服务和图像目录的指南和最佳做法。

Visual Studio 2015 中引入的图像服务使开发人员能够获取适合设备的最佳图像以及用户选择的显示图像的主题，包括针对显示图像的上下文的正确主题。 采用图像服务将有助于消除与资产维护、HDPI 缩放和主题相关的主要痛点。

今天的问题 解决方案
背景色混合 内置 alpha 值混合处理
主题化（一些）图像 主题元数据
高对比度模式 备用高对比度资源
需要适用于不同 DPI 模式的多种资源 具有基于矢量回退功能的可选资源
重复图像 每个图像概念一个标识符

为什么采用图像服务？

  • 始终从 Visual Studio 获取最新的“完美像素”图像

  • 可以提交和使用自己的图像

  • 当 Windows 添加新的 DPI 缩放时，无需测试图像

  • 解决实施中的旧架构障碍

    使用图像服务前后的 Visual Studio shell 工具栏：

    使用图像服务之前和之后

工作原理

图像服务可以提供适合任何支持的 UI 框架的位图图像：

  • WPF：BitmapSource

  • WinForms：System.Drawing.Bitmap

  • Win32：HBITMAP

    图像服务流程图

    图像服务流程图

    图像名字对象

    图像名字对象（或简称名字对象）是一个 GUID/ID 对，用于唯一标识图像库中的图像资产或图像列表资产。

    已知名字对象

    Visual Studio 图像目录中包含的图像名字对象集，可由任何 Visual Studio 组件或扩展公开使用。

    图像清单文件

    图像清单 (.imagemanifest) 文件是定义一组图像资产的 XML 文件、表示这些资产的名字对象，以及表示每个资产的真实图像或图像。 图像清单可以为旧版 UI 支持定义独立图像或图像列表。 此外，还可以在每个资产后面的单个图像上设置属性，以更改这些资产的显示时间和方式。

    图像清单架构

    完整的图像清单如下所示：

<ImageManifest>
      <!-- zero or one Symbols elements -->
      <Symbols>
        <!-- zero or more Import, Guid, ID, or String elements -->
      </Symbols>
      <!-- zero or one Images elements -->
      <Images>
        <!-- zero or more Image elements -->
      </Images>
      <!-- zero or one ImageLists elements -->
      <ImageLists>
        <!-- zero or more ImageList elements -->
      </ImageLists>
</ImageManifest>

符号

。作为可读性和维护帮助，图像清单可以使用符号作为属性值。 符号定义如下：

<Symbols>
      <Import Manifest="manifest" />
      <Guid Name="ShellCommandGuid" Value="8ee4f65d-bab4-4cde-b8e7-ac412abbda8a" />
      <ID Name="cmdidSaveAll" Value="1000" />
      <String Name="AssemblyName" Value="Microsoft.VisualStudio.Shell.UI.Internal" />
</Symbols>
子元素 定义
Import 导入给定清单文件的符号，以便在当前清单中使用
Guid 该符号表示 GUID，必须与 GUID 格式匹配
ID 该符号表示 ID，必须为非负整数
String 该符号表示任意字符串值

符号区分大小写，并使用 $(symbol-name) 语法引用：

<Image Guid="$(ShellCommandGuid)" ID="$(cmdidSaveAll)" >
      <Source Uri="/$(AssemblyName);Component/Resources/image.xaml" />
</Image>

有些符号是为所有清单预定义的。 这些符号可以在 <Source> 或 <Import> 元素的 Uri 属性中使用，以引用本地计算机上的路径。

符号 描述
CommonProgramFiles %CommonProgramFiles% 环境变量的值
LocalAppData %LocalAppData% 环境变量的值
ManifestFolder 包含清单文件的文件夹
MyDocuments 当前用户的“我的文档”文件夹的完整路径
ProgramFiles %ProgramFiles% 环境变量的值
System Windows\System32 文件夹
WinDir %WinDir% 环境变量的值

Image

<Image> 元素定义可由名字对象引用的图像。 GUID 和 ID 共同构成图像名字对象。 图像的名字对象在整个图像库中必须是唯一的。 如果多个图像具有给定的名字对象，则将保留构建库时遇到的第一个图像。

必须包含至少一个源。 中性尺寸的源可在各种尺寸中提供最佳效果，但这不是必需的。 如果服务请求的图像尺寸未在 <Image> 元素中定义，并且没有中性尺寸的源，则服务将选择最佳的特定尺寸的源并将其缩放到请求的尺寸。

<Image Guid="guid" ID="int" AllowColorInversion="true/false">
      <Source ... />
      <!-- optional additional Source elements -->
</Image>
属性 定义
Guid [必需]图像名字对象的 GUID 部分
ID [必需]图像名字对象的 ID 部分
AllowColorInversion [可选，默认值为 true]指示在深色背景上使用图像时，是否可以以编程方式反转其颜色。

Source

<Source> 元素定义单个图像源资产（XAML 和 PNG）。

<Source Uri="uri" Background="background">
      <!-- optional NativeResource element -->
 </Source>
属性 定义
Uri [必需]一个 URI，用于定义可从中加载图像的位置。 该参数可以是下列值之一：

- 使用 application:/// 权限的 Pack URI
- 绝对的组件资源参考
- 包含本机资源的文件的路径
背景 [可选]指示源要使用的背景类型。

该参数可以是下列值之一：

浅色：源可用于浅色背景。

深色：源可用于深色背景。

HighContrast：源可在高对比度模式下的任何背景上使用。

HighContrastLight：源可在高对比度模式下的浅色背景上使用。

HighContrastDark：源可在高对比度模式下的深色背景上使用。

如果省略背景属性，则可以在任何背景上使用源。

如果背景为 Light、Dark、HighContrastLight 或 HighContrastDark，则源的颜色永远不会反转。 如果省略“背景”或将其设置为 HighContrast，则源颜色的反转由图像的 AllowColorInversion 属性控制。

<Source> 元素可以正好具有以下可选子元素之一：

元素 属性（全部必需） 定义
<大小> 值 源将用于给定尺寸的图像（以设备单元表示）。 图像将为正方形。
<SizeRange> MinSize、MaxSize 源将用于从 MinSize 到 MaxSize（含两者）的图像（以设备单元表示）。 图像将为正方形。
<Dimensions> Width, Height 源将用于给定宽度和高度的图像（以设备单元表示）。
<DimensionRange> MinWidth、MinHeight、

MaxWidth、MaxHeight		 源将用于从最小宽度/高度到最大宽度/高度的图像（以设备单元表示）。

<Source> 元素还可以具有可选的 <NativeResource> 子元素，该子元素定义从本机程序集而不是托管程序集加载的 <Source>。

<NativeResource Type="type" ID="int" />
属性 定义
类型 [必需]本机资源的类型，即 XAML 或 PNG
ID [必需]本机资源的整数 ID 部分

ImageList

<ImageList> 元素定义可在单个条带中返回的图像集合。 条带按需构建。

<ImageList>
      <ContainedImage Guid="guid" ID="int" External="true/false" />
      <!-- optional additional ContainedImage elements -->
 </ImageList>
属性 定义
Guid [必需]图像名字对象的 GUID 部分
ID [必需]图像名字对象的 ID 部分
外部 [可选，默认值为 false]指示图像名字对象是否引用当前清单中的图像。

包含图像的名字对象不必引用当前清单中定义的图像。 如果在图像库中找不到包含的图像，则将使用空白占位符图像来代替它。

使用图像服务

初始步骤（托管）

若要使用图像服务，需要向项目添加对部分或全部程序集的引用：

  • Microsoft.VisualStudio.ImageCatalog.dll

    • 如果使用内置图像目录 KnownMonikers，则为必需项。

  • Microsoft.VisualStudio.Imaging.dll

    • 如果在 WPF UI 中使用 CrispImage 和 ImageThemingUtilities，则为必需项。

  • Microsoft.VisualStudio.Imaging.Interop.14.0.DesignTime.dll

    • 如果使用 ImageMoniker 和 ImageAttributes 类型，则为必需项。

    • EmbedInteropTypes 应设置为 true。

  • Microsoft.VisualStudio.Shell.Interop.14.0.DesignTime

    • 如果使用 IVsImageService2 类型，则为必需项。

    • EmbedInteropTypes 应设置为 true。

  • Microsoft.VisualStudio.Utilities.dll

    • 如果对 WPF UI 中的 ImageThemingUtilities.ImageBackgroundColor 使用 BrushToColorConverter，则为必需项。

  • Microsoft.VisualStudio.Shell.<VSVersion>.0

    • 如果使用 IVsUIObject 类型，则为必需项。

  • Microsoft.VisualStudio.Shell.Interop.10.0.dll

    • 如果使用与 WinForms 相关的 UI 帮助程序，则为必需项。

    • EmbedInteropTypes 应设置为 true

初始步骤（本机）

若要使用图像服务，则需要将以下部分或全部标头包含到项目中：

  • KnownImageIds.h

    • 如果使用内置图像目录 KnownMonikers，但无法使用 ImageMoniker 类型（例如从 IVsHierarchy GetGuidProperty 或 GetProperty 调用返回值时），则为必需项。

  • KnownMonikers.h

    • 如果使用内置图像目录 KnownMonikers，则为必需项。

  • ImageParameters140.h

    • 如果使用 ImageMoniker 和 ImageAttributes 类型，则为必需项。

  • VSShell140.h

    • 如果使用 IVsImageService2 类型，则为必需项。

  • ImageThemingUtilities.h

    • 如果无法让图像服务为你处理主题，则为必需项。

    • 如果图像服务可以处理图像主题，请不要使用此标头。

  • VsDpiAwareness.h

    • 如果使用 DPI 感知帮助程序获取当前 DPI，则为必需项。

如何编写新的 WPF UI？

  1. 首先将上面“初始步骤”部分所需的程序集引用添加到项目。 无需添加所有这些引用，因此只需添加所需的引用。 （注意：如果你正在使用或有权访问颜色而不是画笔，则可以跳过对实用程序的引用，因为你不需要转换器。）

  2. 选择所需的图像并获取其名字对象。 使用 KnownMoniker，如果你拥有自己的自定义映像和名字对象，请使用自己的映像和名字对象。

  3. 将 CrispImages 添加到 XAML。 （请参阅下面的示例。）

  4. 在 UI 层次结构中设置 ImageThemingUtilities.ImageBackgroundColor 属性。 （这应该在已知背景色的位置设置，不一定在 CrispImage 上。）（请参阅下面的示例。）

<Window
  x:Class="WpfApplication.MainWindow"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:imaging="clr-namespace:Microsoft.VisualStudio.Imaging;assembly=Microsoft.VisualStudio.Imaging"
  xmlns:theming="clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Imaging"
  xmlns:utilities="clr-namespace:Microsoft.VisualStudio.PlatformUI;assembly=Microsoft.VisualStudio.Utilities"
  xmlns:catalog="clr-namespace:Microsoft.VisualStudio.Imaging;assembly=Microsoft.VisualStudio.ImageCatalog"
  Title="MainWindow" Height="350" Width="525" UseLayoutRounding="True">
  <Window.Resources>
    <utilities:BrushToColorConverter x:Key="BrushToColorConverter"/>
  </Window.Resources>
  <StackPanel Background="White" VerticalAlignment="Center"
    theming:ImageThemingUtilities.ImageBackgroundColor="{Binding Background, RelativeSource={RelativeSource Self}, Converter={StaticResource BrushToColorConverter}}">
    <imaging:CrispImage Width="16" Height="16" Moniker="{x:Static catalog:KnownMonikers.MoveUp}" />
  </StackPanel>
</Window>

如何更新现有的 WPF UI？

更新现有 WPF UI 是一个相对简单的过程，包含三个基本步骤：

  1. 将 UI 中的所有 <Image> 元素替换为 <CrispImage> 元素。

  2. 将所有 Source 属性更改为 Moniker 属性。

    • 如果图像永远不会更改，并且你正在使用 KnownMonikers，则将该属性静态绑定到 KnownMoniker。 （请参阅上面的示例。）

    • 如果图像永远不会更改，并且你使用的是自己的自定义图像，则静态绑定到自己的名字对象。

    • 如果图像可以更改，请将 Moniker 属性绑定到通知属性更改的代码属性。

  3. 在 UI 层次结构中的某个位置，设置 ImageThemingUtilities.ImageBackgroundColor 以确保颜色反转正常工作。

    • 这可能需要使用 BrushToColorConverter 类。 （请参阅上面的示例。）

如何更新 Win32 UI？

在适当位置将以下内容添加到代码中，以替换图像的原始加载。 根据需要切换用于返回 HBITMAP、HICON 与 HIMAGELIST 的值。

获取图像服务

CComPtr<IVsImageService2> spImgSvc;
CGlobalServiceProvider::HrQueryService(SID_SVsImageService, &spImgSvc);

请求图像

UINT dpiX, dpiY;
HWND hwnd = // get the HWND where the image will be displayed
VsUI::CDpiAwareness::GetDpiForWindow(hwnd, &dpiX, &dpiY);

ImageAttributes attr = { 0 };
attr.StructSize      = sizeof(attributes);
attr.Format          = DF_Win32;
// IT_Bitmap for HBITMAP, IT_Icon for HICON, IT_ImageList for HIMAGELIST
attr.ImageType       = IT_Bitmap;
attr.LogicalWidth    = 16;
attr.LogicalHeight   = 16;
attr.Dpi             = dpiX;
// Desired RGBA color, if you don't use this, don't set IAF_Background below
attr.Background      = 0xFFFFFFFF;
attr.Flags           = IAF_RequiredFlags | IAF_Background;

CComPtr<IVsUIObject> spImg;
// Replace this KnownMoniker with your desired ImageMoniker
spImgSvc->GetImage(KnownMonikers::Blank, attributes, &spImg);

如何更新 WinForms UI？

在适当位置将以下内容添加到代码中，以替换图像的原始加载。 根据需要切换用于返回位图与图标的值。

有用的 using 语句

using GelUtilities = Microsoft.Internal.VisualStudio.PlatformUI.Utilities;

获取图像服务

// This or your preferred way of querying for Visual Studio services
IVsImageService2 imageService = (IVsImageService2)Package.GetGlobalService(typeof(SVsImageService));

请求图像

Control control = // get the control where the image will be displayed

ImageAttributes attributes = new ImageAttributes
{
    StructSize    = Marshal.SizeOf(typeof(ImageAttributes)),
    // IT_Bitmap for Bitmap, IT_Icon for Icon, IT_ImageList for ImageList
    ImageType     = (uint)_UIImageType.IT_Bitmap,
    Format        = (uint)_UIDataFormat.DF_WinForms,
    LogicalWidth  = 16,
    LogicalHeight = 16,
    Dpi           = (int)DpiAwareness.GetWindowDpi(control.Handle);
    // Desired RGBA color, if you don't use this, don't set IAF_Background below
    Background    = 0xFFFFFFFF,
    Flags         = unchecked((uint)_ImageAttributesFlags.IAF_RequiredFlags | _ImageAttributesFlags.IAF_Background),
};

// Replace this KnownMoniker with your desired ImageMoniker
IVsUIObject uIObj = imageService.GetImage(KnownMonikers.Blank, attributes);

Bitmap bitmap = (Bitmap)GelUtilities.GetObjectData(uiObj); // Use this if you need a bitmap
// Icon icon = (Icon)GelUtilities.GetObjectData(uiObj);    // Use this if you need an icon

如何在新工具窗口中使用图像名字对象？

VSIX 包项目模板已针对 Visual Studio 2015 进行了更新。 若要创建新工具窗口，请右键单击 VSIX 项目，然后选择“添加”>“新项”(Ctrl+Shift+A)。 在项目语言的扩展性节点下，选择“自定义工具窗口”，为工具窗口命名，然后按添加按钮。

以下是在工具窗口中使用名字对象的关键位置。 请按照每个位置的说明进行操作：

  1. 当选项卡足够小时，则在“工具窗口”选项卡中使用（也在 Ctrl+Tab 窗口切换器中使用）。

    将此行添加到派生自 ToolWindowPane 类型的类的构造函数：

    // Replace this KnownMoniker with your desired ImageMoniker
this.BitmapImageMoniker = KnownMonikers.Blank;

  2. 用于打开工具窗口的命令。

    在 .vsct 包的文件中，编辑工具窗口的命令按钮：

    <Button guid="guidPackageCmdSet" id="CommandId" priority="0x0100" type="Button">
  <Parent guid="guidSHLMainMenu" id="IDG_VS_WNDO_OTRWNDWS1"/>
  <!-- Replace this KnownMoniker with your desired ImageMoniker -->
  <Icon guid="ImageCatalogGuid" id="Blank" />
  <!-- Add this -->
  <CommandFlag>IconIsMoniker</CommandFlag>
  <Strings>
    <ButtonText>MyToolWindow</ButtonText>
  </Strings>
</Button>

    确保以下内容也存在于文件顶部的 <Extern> 元素之后：

    <Include href="KnownImageIds.vsct"/>

如何在现有工具窗口中使用图像名字对象？

更新现有工具窗口以使用图像名字对象的步骤与创建新工具窗口相似。

以下是在工具窗口中使用名字对象的关键位置。 请按照每个位置的说明进行操作：

  1. 当选项卡足够小时，则在“工具窗口”选项卡中使用（也在 Ctrl+Tab 窗口切换器中使用）。

    1. 从派生自 ToolWindowPane 类型的类的构造函数中删除这些行（如果存在）：

      this.BitmapResourceID = <Value>;
this.BitmapIndex = <Value>;

    2. 请参阅上面的“如何在新工具窗口中使用图像名字对象？”部分的步骤 1。

  2. 用于打开工具窗口的命令。

    • 请参阅上面的“如何在新工具窗口中使用图像名字对象？”部分的步骤 2。

如何在 .vsct 文件中使用图像名字对象？

按以下注释行的指示更新 .vsct 文件：

<?xml version="1.0" encoding="utf-8"?>
<CommandTable xmlns="http://schemas.microsoft.com/VisualStudio/2005-10-18/CommandTable" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <!--  Include the definitions for images included in the VS image catalog -->
  <Include href="KnownImageIds.vsct"/>
  <Commands package="guidMyPackage">
    <Buttons>
      <Button guid="guidMyCommandSet" id="cmdidMyCommand" priority="0x0000" type="Button">
        <!-- Add an Icon element, changing the attributes to match the image moniker you want to use.
             In this case, we're using the Guid for the VS image catalog.
             Change the id attribute to be the ID of the desired image moniker. -->
        <Icon guid="ImageCatalogGuid" id="OpenFolder" />
        <CommandFlag>DynamicVisibility</CommandFlag>
        <CommandFlag>DefaultInvisible</CommandFlag>
        <CommandFlag>DefaultDisabled</CommandFlag>
        <CommandFlag>CommandWellOnly</CommandFlag>
        <CommandFlag>IconAndText</CommandFlag>
        <!-- Add the IconIsMoniker CommandFlag -->
        <CommandFlag>IconIsMoniker</CommandFlag>
        <Strings>
          <ButtonText>Quick Fixes...</ButtonText>
          <CommandName>Show Quick Fixes</CommandName>
          <CanonicalName>ShowQuickFixes</CanonicalName>
          <LocCanonicalName>ShowQuickFixes</LocCanonicalName>
        </Strings>
      </Button>
    </Buttons>
  </Commands>
  <!-- It is recommended that you remove <Bitmap> elements that are no longer used in the vsct file -->
  <Symbols>
    <GuidSymbol name="guidMyPackage"    value="{1491e936-6ffe-474e-8371-30e5920d8fdd}" />
    <GuidSymbol name="guidMyCommandSet" value="{10347de4-69a9-47f4-a950-d3301f6d2bc7}">
      <IDSymbol name="cmdidMyCommand" value="0x9437" />
    </GuidSymbol>
  </Symbols>
</CommandTable>

如果我的 .vsct 文件还需要由旧版本的 Visual Studio 读取，该怎么办？

旧版本的 Visual Studio 无法识别 IconIsMoniker 命令标志。 可以在支持图像服务的 Visual Studio 版本上使用图像服务中的图像，但在旧版本的 Visual Studio 上继续使用旧式图像。 为此，需要将 .vsct 文件保持不变（因此与旧版本的 Visual Studio 兼容），并创建一个 CSV（逗号分隔值）文件，该文件从 .vsct 文件的 <Bitmaps> 元素 中定义的 GUID/ID 对映射到图像名字对象 GUID/ID 对。

映射 CSV 文件的格式为：

Icon guid, Icon id, Moniker guid, Moniker id
b714fcf7-855e-4e4c-802a-1fd87144ccad,1,fda30684-682d-421c-8be4-650a2967058e,100
b714fcf7-855e-4e4c-802a-1fd87144ccad,2,fda30684-682d-421c-8be4-650a2967058e,200

CSV 文件随包一起部署，其位置由 ProvideMenuResource 包属性的 IconMappingFilename 属性指定：

[ProvideMenuResource("MyPackage.ctmenu", 1, IconMappingFilename="IconMappings.csv")]

IconMappingFilename 可以以 $PackageFolder$ 的相对路径（如上例所示）为隐式根目录，或者以环境变量定义的目录的绝对路径，如 @"%UserProfile%\dir1\dir2\MyMappingFile.csv" 为显式根目录。

如何移植项目系统？

如何为项目提供 ImageMonikers

  1. 在项目的 IVsHierarchy 上实施 VSHPROPID_SupportsIconMonikers，并返回 true。

  2. 实施 VSHPROPID_IconMonikerImageList（如果原始项目使用 VSHPROPID_IconImgList）或 VSHPROPID_IconMonikerGuid、VSHPROPID_IconMonikerId、VSHPROPID_OpenFolderIconMonikerGuid、VSHPROPID_OpenFolderIconMonikerId（如果原始项目使用 VSHPROPID_IconHandle 和 VSHPROPID_OpenFolderIconHandle）。

  3. 更改图标的原始 VSHPROPID 的实施，以便在扩展点请求它们时创建图标的“旧”版本。 IVsImageService2 提供获取这些图标所需的功能

    VB/C# 项目风格的额外要求

    仅当检测到项目是最外层的风格时，才实施 VSHPROPID_SupportsIconMonikers。 否则，真实的最外层风格实际上可能不支持图像名称，并且基本风格可能会有效地“隐藏”自定义图像。

    如何在 CPS 中使用图像名称？

    可以手动或通过项目系统扩展性 SDK 附带的项目模板在 CPS（通用项目系统）中设置自定义图像。

    使用项目系统扩展性 SDK

    按照“为项目类型/项目类型提供自定义图标”中的说明自定义 CPS 图像。 有关 CPS 的详细信息，请参阅 Visual Studio 项目系统扩展性文档

    手动使用 ImageMonikers

  4. 在项目系统中实施和导出 IProjectTreeModifier 接口。

  5. 确定要使用的 KnownMoniker 或自定义图像名字对象。

  6. 在 ApplyModifications 方法中，在返回新树之前，在方法中执行以下操作，如以下示例所示：

    // Replace this KnownMoniker with your desired ImageMoniker
tree = tree.SetIcon(KnownMonikers.Blank.ToProjectSystemType());

  7. 如果要创建新树，可以通过将所需名字对象传入 NewTree 方法来设置自定义图像，如以下示例所示：

    // Replace this KnownMoniker with your desired ImageMoniker
ProjectImageMoniker icon         = KnownMonikers.FolderClosed.ToProjectSystemType();
ProjectImageMoniker expandedIcon = KnownMonikers.FolderOpened.ToProjectSystemType();

return this.ProjectTreeFactory.Value.NewTree(/*caption*/<value>,
                                             /*filePath*/<value>,
                                             /*browseObjectProperties*/<value>,
                                             icon,
                                             expandedIcon);

如何从真实图像条带转换为基于名字对象的图像条带？

我需要支持 HIMAGELIST

如果代码已经有一个图像条带，你想要更新它以使用图像服务，但受到需要传递图像列表的 API 的限制，你仍然可以享受图像服务带来的好处。 若要创建基于名字对象的图像条带，请按照以下步骤从现有名字对象创建清单。

  1. 运行 ManifestFromResources 工具，向其传递图像条带。 这将为该条带生成清单。

    • 建议：为清单提供一个非默认名称，以适合其用法。

  2. 如果仅使用 KnownMonikers，请执行以下操作：

    • 将清单的 <Image> 部分替换为 <Images/>。

    • 删除所有子图像 ID（任何带有 <imagestrip name>_## 的 ID）。

    • 建议：重命名 AssetsGuid 符号和图像条带符号以适合其用法。

    • 将每个 ContainedImage 的 GUID 替换为 $(ImageCatalogGuid)，将每个 ContainedImage 的 ID 替换为 $(<moniker>)，然后向每个 ContainedImage 添加 External="true" 属性

      • <moniker> 应替换为与图像匹配的 KnownMoniker，但从名称中删除“KnownMonikers.”。

    • 将 <Import Manifest="$(ManifestFolder)\<Relative install dir path to *>\Microsoft.VisualStudio.ImageCatalog.imagemanifest" /*> 添加到 <Symbols> 部分顶部。

      • 相对路径由为清单创作设置时定义的部署位置确定。

  3. 运行 ManifestToCode 工具以生成包装器，这样，现有代码将具有一个名字对象，可用于查询图像服务的图像条带。

    • 建议：为包装器和命名空间提供非默认名称以适合其用法。

  4. 执行所有添加、设置创作/部署和其他代码更改以使用影像服务和新文件。包含内部和外部图像的清单示例，以查看其外观：

    示例清单，包括内部和外部图像，以查看其外观：

<?xml version="1.0"?>
<ImageManifest
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns="http://schemas.microsoft.com/VisualStudio/ImageManifestSchema/2014">

  <Symbols>
    <!-- This needs to be the relative path from your manifest to the ImageCatalog's manifest
         where $(ManifestFolder) is the deployed location of this manifest. -->
    <Import Manifest="$(ManifestFolder)\<RelPath>\Microsoft.VisualStudio.ImageCatalog.imagemanifest" />

    <String Name="Resources" Value="/My.Assembly.Name;Component/Resources/ImageStrip" />
    <Guid Name="ImageGuid" Value="{fb41b7ef-6587-480c-aa27-5b559d42cfc9}" />
    <Guid Name="ImageStripGuid" Value="{9c84a570-d9a7-4052-a340-188fb276f973}" />
    <ID Name="MyImage_0" Value="100" />
    <ID Name="MyImage_1" Value="101" />
    <ID Name="InternalList" Value="1001" />
    <ID Name="ExternalList" Value="1002" />
  </Symbols>

  <Images>
    <Image Guid="$(ImageGuid)" ID="$(MyImage_0)">
      <Source Uri="$(Resources)/MyImage_0.png">
        <Size Value="16" />
      </Source>
    </Image>
    <Image Guid="$(ImageGuid)" ID="$(MyImage_1)">
      <Source Uri="$(Resources)/MyImage_1.png">
        <Size Value="16" />
      </Source>
    </Image>
  </Images>

  <ImageLists>
    <ImageList Guid="$(ImageStripGuid)" ID="$(InternalList)">
      <ContainedImage Guid="$(ImageGuid)" ID="$(MyImage_0)" />
      <ContainedImage Guid="$(ImageGuid)" ID="$(MyImage_1)" />
    </ImageList>
    <ImageList Guid="$(ImageStripGuid)" ID="$(ExternalList)">
      <ContainedImage Guid="$(ImageCatalogGuid)" ID="$(StatusError)" External="true" />
      <ContainedImage Guid="$(ImageCatalogGuid)" ID="$(StatusWarning)" External="true" />
      <ContainedImage Guid="$(ImageCatalogGuid)" ID="$(StatusInformation)" External="true" />
    </ImageList>
  </ImageLists>

</ImageManifest>

我不需要支持 HIMAGELIST

  1. 确定与图像条带中的图像匹配的 KnownMonikers 集，或为图像条带中的图像创建自己的名字对象。

  2. 更新用于获取图像条中所需索引处的图像的任何映射，以改用名字对象。

  3. 更新代码以使用图像服务通过更新的图像请求名字对象。 （这可能意味着更新到 CrispImages 以获取托管代码，或者从图像服务请求 HBITMAP 或 HICON，并将它们传递给本机代码。）

测试图像

可以使用图像库查看器工具测试图像清单，以确保正确创作所有内容。 可以在 Visual Studio 2015 SDK 中找到该工具。 此工具及其他工具的文档可在此处找到。

其他资源

示例

GitHub 上的几个 Visual Studio 示例已更新，以展示如何使用图像服务作为各种 Visual Studio 扩展点的一部分。

检查 http://github.com/Microsoft/VSSDK-Extensibility-Samples 获取最新示例。

工具

创建了一组图像服务支持工具，以帮助创建/更新与图像服务配合使用的 UI。 有关每个工具的更多信息，请查看工具附带的文档。 这些工具包含在 Visual Studio 2015 SDK 中。

ManifestFromResources

Manifest from Resources 工具获取图像资源（PNG 或 XAML）列表并生成图像清单文件，以便通过图像服务使用这些图像。

ManifestToCode

Manifest to Code 工具采用图像清单文件并生成包装器文件，用于引用代码（C++、C# 或 VB）或 .vsct 文件中的清单值。

ImageLibraryViewer

图片库查看器图像库查看器工具可以加载图像清单，并允许用户以与 Visual Studio 相同的方式操作它们，以确保正确编写清单。 用户可以更改背景、尺寸、DPI 设置、高对比度和其他设置。 它还显示加载信息以查找清单中的错误，并显示清单中每个图像的源信息。

常见问题解答

  • 加载 <Reference Include="Microsoft.VisualStudio.*.Interop.14.0.DesignTime" /> 时，时是否必须包含任何依赖项？

    • 在所有互操作 DLL 上设置 EmbedInteropTypes="true"。

  • 如何使用扩展部署映像清单？

    • 将 .imagemanifest 文件添加到项目。

    • 将“包含在 VSIX 中”设置为“True”。

  • 我正在更新 CPS 项目系统。 ImageName and StockIconService 发生了什么情况？

    • 当 CPS 更新为使用名字对象时，这些属性会被删除。 不再需要调用 StockIconService，只需使用 CPS 实用工具中的 ToProjectSystemType() 扩展方法将所需的 KnownMoniker 传递给方法或属性。 可以在下面找到从 ImageName 到 KnownMonikers 的映射：

      ImageName KnownMoniker
      ImageName.OfflineWebApp KnownImageIds.Web
      ImageName.WebReferencesFolder KnownImageIds.Web
      ImageName.OpenReferenceFolder KnownImageIds.FolderOpened
      ImageName.ReferenceFolder KnownImageIds.Reference
      ImageName.Reference KnownImageIds.Reference
      ImageName.SdlWebReference KnownImageIds.WebReferenceFolder
      ImageName.DiscoWebReference KnownImageIds.DynamicDiscoveryDocument
      ImageName.Folder KnownImageIds.FolderClosed
      ImageName.OpenFolder KnownImageIds.FolderOpened
      ImageName.ExcludedFolder KnownImageIds.HiddenFolderClosed
      ImageName.OpenExcludedFolder KnownImageIds.HiddenFolderOpened
      ImageName.ExcludedFile KnownImageIds.HiddenFile
      ImageName.DependentFile KnownImageIds.GenerateFile
      ImageName.MissingFile KnownImageIds.DocumentWarning
      ImageName.WindowsForm KnownImageIds.WindowsForm
      ImageName.WindowsUserControl KnownImageIds.UserControl
      ImageName.WindowsComponent KnownImageIds.ComponentFile
      ImageName.XmlSchema KnownImageIds.XMLSchema
      ImageName.XmlFile KnownImageIds.XMLFile
      ImageName.WebForm KnownImageIds.Web
      ImageName.WebService KnownImageIds.WebService
      ImageName.WebUserControl KnownImageIds.WebUserControl
      ImageName.WebCustomUserControl KnownImageIds.WebCustomControl
      ImageName.AspPage KnownImageIds.ASPFile
      ImageName.GlobalApplicationClass KnownImageIds.SettingsFile
      ImageName.WebConfig KnownImageIds.ConfigurationFile
      ImageName.HtmlPage KnownImageIds.HTMLFile
      ImageName.StyleSheet KnownImageIds.StyleSheet
      ImageName.ScriptFile KnownImageIds.JSScript
      ImageName.TextFile KnownImageIds.Document
      ImageName.SettingsFile KnownImageIds.Settings
      ImageName.Resources KnownImageIds.DocumentGroup
      ImageName.Bitmap KnownImageIds.Image
      ImageName.Icon KnownImageIds.IconFile
      ImageName.Image KnownImageIds.Image
      ImageName.ImageMap KnownImageIds.ImageMapFile
      ImageName.XWorld KnownImageIds.XWorldFile
      ImageName.Audio KnownImageIds.Sound
      ImageName.Video KnownImageIds.Media
      ImageName.Cab KnownImageIds.CABProject
      ImageName.Jar KnownImageIds.JARFile
      ImageName.DataEnvironment KnownImageIds.DataTable
      ImageName.PreviewFile KnownImageIds.Report
      ImageName.DanglingReference KnownImageIds.ReferenceWarning
      ImageName.XsltFile KnownImageIds.XSLTransform
      ImageName.Cursor KnownImageIds.CursorFile
      ImageName.AppDesignerFolder KnownImageIds.Property
      ImageName.Data KnownImageIds.Database
      ImageName.Application KnownImageIds.Application
      ImageName.DataSet KnownImageIds.DatabaseGroup
      ImageName.Pfx KnownImageIds.Certificate
      ImageName.Snk KnownImageIds.Rule
      ImageName.VisualBasicProject KnownImageIds.VBProjectNode
      ImageName.CSharpProject KnownImageIds.CSProjectNode
      ImageName.Empty KnownImageIds.Blank
      ImageName.MissingFolder KnownImageIds.FolderOffline
      ImageName.SharedImportReference KnownImageIds.SharedProject
      ImageName.SharedProjectCs KnownImageIds.CSSharedProject
      ImageName.SharedProjectVc KnownImageIds.CPPSharedProject
      ImageName.SharedProjectJs KnownImageIds.JSSharedProject
      ImageName.CSharpCodeFile KnownImageIds.CSFileNode
      ImageName.VisualBasicCodeFile KnownImageIds.VBFileNode

    • 我正在更新完成列表提供程序。 哪些 KnownMonikers 与旧的 StandardGlyphGroup 和 StandardGlyph 值匹配？

      名称 名称 名称
      GlyphGroupClass GlyphItemPublic ClassPublic
      GlyphGroupClass GlyphItemInternal ClassInternal
      GlyphGroupClass GlyphItemFriend ClassInternal
      GlyphGroupClass GlyphItemProtected ClassProtected
      GlyphGroupClass GlyphItemPrivate ClassPrivate
      GlyphGroupClass GlyphItemShortcut ClassShortcut
      GlyphGroupConstant GlyphItemPublic ConstantPublic
      GlyphGroupConstant GlyphItemInternal ConstantInternal
      GlyphGroupConstant GlyphItemFriend ConstantInternal
      GlyphGroupConstant GlyphItemProtected ConstantProtected
      GlyphGroupConstant GlyphItemPrivate ConstantPrivate
      GlyphGroupConstant GlyphItemShortcut ConstantShortcut
      GlyphGroupDelegate GlyphItemPublic DelegatePublic
      GlyphGroupDelegate GlyphItemInternal DelegateInternal
      GlyphGroupDelegate GlyphItemFriend DelegateInternal
      GlyphGroupDelegate GlyphItemProtected DelegateProtected
      GlyphGroupDelegate GlyphItemPrivate DelegatePrivate
      GlyphGroupDelegate GlyphItemShortcut DelegateShortcut
      GlyphGroupEnum GlyphItemPublic EnumerationPublic
      GlyphGroupEnum GlyphItemInternal EnumerationInternal
      GlyphGroupEnum GlyphItemFriend EnumerationInternal
      GlyphGroupEnum GlyphItemProtected EnumerationProtected
      GlyphGroupEnum GlyphItemPrivate EnumerationPrivate
      GlyphGroupEnum GlyphItemShortcut EnumerationShortcut
      GlyphGroupEnumMember GlyphItemPublic EnumerationItemPublic
      GlyphGroupEnumMember GlyphItemInternal EnumerationItemInternal
      GlyphGroupEnumMember GlyphItemFriend EnumerationItemInternal
      GlyphGroupEnumMember GlyphItemProtected EnumerationItemProtected
      GlyphGroupEnumMember GlyphItemPrivate EnumerationItemPrivate
      GlyphGroupEnumMember GlyphItemShortcut EnumerationItemShortcut
      GlyphGroupEvent GlyphItemPublic EventPublic
      GlyphGroupEvent GlyphItemInternal EventInternal
      GlyphGroupEvent GlyphItemFriend EventInternal
      GlyphGroupEvent GlyphItemProtected EventProtected
      GlyphGroupEvent GlyphItemPrivate EventPrivate
      GlyphGroupEvent GlyphItemShortcut EventShortcut
      GlyphGroupException GlyphItemPublic ExceptionPublic
      GlyphGroupException GlyphItemInternal ExceptionInternal
      GlyphGroupException GlyphItemFriend ExceptionInternal
      GlyphGroupException GlyphItemProtected ExceptionProtected
      GlyphGroupException GlyphItemPrivate ExceptionPrivate
      GlyphGroupException GlyphItemShortcut ExceptionShortcut
      GlyphGroupField GlyphItemPublic FieldPublic
      GlyphGroupField GlyphItemInternal FieldInternal
      GlyphGroupField GlyphItemFriend FieldInternal
      GlyphGroupField GlyphItemProtected FieldProtected
      GlyphGroupField GlyphItemPrivate FieldPrivate
      GlyphGroupField GlyphItemShortcut FieldShortcut
      GlyphGroupInterface GlyphItemPublic InterfacePublic
      GlyphGroupInterface GlyphItemInternal InterfaceInternal
      GlyphGroupInterface GlyphItemFriend InterfaceInternal
      GlyphGroupInterface GlyphItemProtected InterfaceProtected
      GlyphGroupInterface GlyphItemPrivate InterfacePrivate
      GlyphGroupInterface GlyphItemShortcut InterfaceShortcut
      GlyphGroupMacro GlyphItemPublic MacroPublic
      GlyphGroupMacro GlyphItemInternal MacroInternal
      GlyphGroupMacro GlyphItemFriend MacroInternal
      GlyphGroupMacro GlyphItemProtected MacroProtected
      GlyphGroupMacro GlyphItemPrivate MacroPrivate
      GlyphGroupMacro GlyphItemShortcut MacroShortcut
      GlyphGroupMap GlyphItemPublic MapPublic
      GlyphGroupMap GlyphItemInternal MapInternal
      GlyphGroupMap GlyphItemFriend MapInternal
      GlyphGroupMap GlyphItemProtected MapProtected
      GlyphGroupMap GlyphItemPrivate MapPrivate
      GlyphGroupMap GlyphItemShortcut MapShortcut
      GlyphGroupMapItem GlyphItemPublic MapItemPublic
      GlyphGroupMapItem GlyphItemInternal MapItemInternal
      GlyphGroupMapItem GlyphItemFriend MapItemInternal
      GlyphGroupMapItem GlyphItemProtected MapItemProtected
      GlyphGroupMapItem GlyphItemPrivate MapItemPrivate
      GlyphGroupMapItem GlyphItemShortcut MapItemShortcut
      GlyphGroupMethod GlyphItemPublic MethodPublic
      GlyphGroupMethod GlyphItemInternal MethodInternal
      GlyphGroupMethod GlyphItemFriend MethodInternal
      GlyphGroupMethod GlyphItemProtected MethodProtected
      GlyphGroupMethod GlyphItemPrivate MethodPrivate
      GlyphGroupMethod GlyphItemShortcut MethodShortcut
      GlyphGroupOverload GlyphItemPublic MethodPublic
      GlyphGroupOverload GlyphItemInternal MethodInternal
      GlyphGroupOverload GlyphItemFriend MethodInternal
      GlyphGroupOverload GlyphItemProtected MethodProtected
      GlyphGroupOverload GlyphItemPrivate MethodPrivate
      GlyphGroupOverload GlyphItemShortcut MethodShortcut
      GlyphGroupModule GlyphItemPublic ModulePublic
      GlyphGroupModule GlyphItemInternal ModuleInternal
      GlyphGroupModule GlyphItemFriend ModuleInternal
      GlyphGroupModule GlyphItemProtected ModuleProtected
      GlyphGroupModule GlyphItemPrivate ModulePrivate
      GlyphGroupModule GlyphItemShortcut ModuleShortcut
      GlyphGroupNamespace GlyphItemPublic NamespacePublic
      GlyphGroupNamespace GlyphItemInternal NamespaceInternal
      GlyphGroupNamespace GlyphItemFriend NamespaceInternal
      GlyphGroupNamespace GlyphItemProtected NamespaceProtected
      GlyphGroupNamespace GlyphItemPrivate NamespacePrivate
      GlyphGroupNamespace GlyphItemShortcut NamespaceShortcut
      GlyphGroupOperator GlyphItemPublic OperatorPublic
      GlyphGroupOperator GlyphItemInternal OperatorInternal
      GlyphGroupOperator GlyphItemFriend OperatorInternal
      GlyphGroupOperator GlyphItemProtected OperatorProtected
      GlyphGroupOperator GlyphItemPrivate OperatorPrivate
      GlyphGroupOperator GlyphItemShortcut OperatorShortcut
      GlyphGroupProperty GlyphItemPublic PropertyPublic
      GlyphGroupProperty GlyphItemInternal PropertyInternal
      GlyphGroupProperty GlyphItemFriend PropertyInternal
      GlyphGroupProperty GlyphItemProtected PropertyProtected
      GlyphGroupProperty GlyphItemPrivate PropertyPrivate
      GlyphGroupProperty GlyphItemShortcut PropertyShortcut
      GlyphGroupStruct GlyphItemPublic StructurePublic
      GlyphGroupStruct GlyphItemInternal StructureInternal
      GlyphGroupStruct GlyphItemFriend StructureInternal
      GlyphGroupStruct GlyphItemProtected StructureProtected
      GlyphGroupStruct GlyphItemPrivate StructurePrivate
      GlyphGroupStruct GlyphItemShortcut StructureShortcut
      GlyphGroupTemplate GlyphItemPublic TemplatePublic
      GlyphGroupTemplate GlyphItemInternal TemplateInternal
      GlyphGroupTemplate GlyphItemFriend TemplateInternal
      GlyphGroupTemplate GlyphItemProtected TemplateProtected
      GlyphGroupTemplate GlyphItemPrivate TemplatePrivate
      GlyphGroupTemplate GlyphItemShortcut TemplateShortcut
      GlyphGroupTypedef GlyphItemPublic TypeDefinitionPublic
      GlyphGroupTypedef GlyphItemInternal TypeDefinitionInternal
      GlyphGroupTypedef GlyphItemFriend TypeDefinitionInternal
      GlyphGroupTypedef GlyphItemProtected TypeDefinitionProtected
      GlyphGroupTypedef GlyphItemPrivate TypeDefinitionPrivate
      GlyphGroupTypedef GlyphItemShortcut TypeDefinitionShortcut
      GlyphGroupType GlyphItemPublic TypePublic
      GlyphGroupType GlyphItemInternal TypeInternal
      GlyphGroupType GlyphItemFriend TypeInternal
      GlyphGroupType GlyphItemProtected TypeProtected
      GlyphGroupType GlyphItemPrivate TypePrivate
      GlyphGroupType GlyphItemShortcut TypeShortcut
      GlyphGroupUnion GlyphItemPublic UnionPublic
      GlyphGroupUnion GlyphItemInternal UnionInternal
      GlyphGroupUnion GlyphItemFriend UnionInternal
      GlyphGroupUnion GlyphItemProtected UnionProtected
      GlyphGroupUnion GlyphItemPrivate UnionPrivate
      GlyphGroupUnion GlyphItemShortcut UnionShortcut
      GlyphGroupVariable GlyphItemPublic FieldPublic
      GlyphGroupVariable GlyphItemInternal FieldInternal
      GlyphGroupVariable GlyphItemFriend FieldInternal
      GlyphGroupVariable GlyphItemProtected FieldProtected
      GlyphGroupVariable GlyphItemPrivate FieldPrivate
      GlyphGroupVariable GlyphItemShortcut FieldShortcut
      GlyphGroupValueType GlyphItemPublic ValueTypePublic
      GlyphGroupValueType GlyphItemInternal ValueTypeInternal
      GlyphGroupValueType GlyphItemFriend ValueTypeInternal
      GlyphGroupValueType GlyphItemProtected ValueTypeProtected
      GlyphGroupValueType GlyphItemPrivate ValueTypePrivate
      GlyphGroupValueType GlyphItemShortcut ValueTypeShortcut
      GlyphGroupIntrinsic GlyphItemPublic ObjectPublic
      GlyphGroupIntrinsic GlyphItemInternal ObjectInternal
      GlyphGroupIntrinsic GlyphItemFriend ObjectInternal
      GlyphGroupIntrinsic GlyphItemProtected ObjectProtected
      GlyphGroupIntrinsic GlyphItemPrivate ObjectPrivate
      GlyphGroupIntrinsic GlyphItemShortcut ObjectShortcut
      GlyphGroupJSharpMethod GlyphItemPublic MethodPublic
      GlyphGroupJSharpMethod GlyphItemInternal MethodInternal
      GlyphGroupJSharpMethod GlyphItemFriend MethodInternal
      GlyphGroupJSharpMethod GlyphItemProtected MethodProtected
      GlyphGroupJSharpMethod GlyphItemPrivate MethodPrivate
      GlyphGroupJSharpMethod GlyphItemShortcut MethodShortcut
      GlyphGroupJSharpField GlyphItemPublic FieldPublic
      GlyphGroupJSharpField GlyphItemInternal FieldInternal
      GlyphGroupJSharpField GlyphItemFriend FieldInternal
      GlyphGroupJSharpField GlyphItemProtected FieldProtected
      GlyphGroupJSharpField GlyphItemPrivate FieldPrivate
      GlyphGroupJSharpField GlyphItemShortcut FieldShortcut
      GlyphGroupJSharpClass GlyphItemPublic ClassPublic
      GlyphGroupJSharpClass GlyphItemInternal ClassInternal
      GlyphGroupJSharpClass GlyphItemFriend ClassInternal
      GlyphGroupJSharpClass GlyphItemProtected ClassProtected
      GlyphGroupJSharpClass GlyphItemPrivate ClassPrivate
      GlyphGroupJSharpClass GlyphItemShortcut ClassShortcut
      GlyphGroupJSharpNamespace GlyphItemPublic NamespacePublic
      GlyphGroupJSharpNamespace GlyphItemInternal NamespaceInternal
      GlyphGroupJSharpNamespace GlyphItemFriend NamespaceInternal
      GlyphGroupJSharpNamespace GlyphItemProtected NamespaceProtected
      GlyphGroupJSharpNamespace GlyphItemPrivate NamespacePrivate
      GlyphGroupJSharpNamespace GlyphItemShortcut NamespaceShortcut
      GlyphGroupJSharpInterface GlyphItemPublic InterfacePublic
      GlyphGroupJSharpInterface GlyphItemInternal InterfaceInternal
      GlyphGroupJSharpInterface GlyphItemFriend InterfaceInternal
      GlyphGroupJSharpInterface GlyphItemProtected InterfaceProtected
      GlyphGroupJSharpInterface GlyphItemPrivate InterfacePrivate
      GlyphGroupJSharpInterface GlyphItemShortcut InterfaceShortcut
      GlyphGroupError StatusError
      GlyphBscFile ClassFile
      GlyphAssembly 参考
      GlyphLibrary 库
      GlyphVBProject VBProjectNode
      GlyphCoolProject CSProjectNode
      GlyphCppProject CPPProjectNode
      GlyphDialogId 对话
      GlyphOpenFolder FolderOpened
      GlyphClosedFolder FolderClosed
      GlyphArrow GoToNext
      GlyphCSharpFile CSFileNode
      GlyphCSharpExpansion 片段
      GlyphKeyword IntellisenseKeyword
      GlyphInformation StatusInformation
      GlyphReference ClassMethodReference
      GlyphRecursion 递归
      GlyphXmlItem 标记
      GlyphJSharpProject DocumentCollection
      GlyphJSharpDocument 文档
      GlyphForwardType GoToNext
      GlyphCallersGraph CallTo
      GlyphCallGraph CallFrom
      GlyphWarning StatusWarning
      GlyphMaybeReference QuestionMark
      GlyphMaybeCaller CallTo
      GlyphMaybeCall CallFrom
      GlyphExtensionMethod ExtensionMethod
      GlyphExtensionMethodInternal ExtensionMethod
      GlyphExtensionMethodFriend ExtensionMethod
      GlyphExtensionMethodProtected ExtensionMethod
      GlyphExtensionMethodPrivate ExtensionMethod
      GlyphExtensionMethodShortcut ExtensionMethod
      GlyphXmlAttribute XmlAttribute
      GlyphXmlChild XmlElement
      GlyphXmlDescendant XmlDescendant
      GlyphXmlNamespace XmlNamespace
      GlyphXmlAttributeQuestion XmlAttributeLowConfidence
      GlyphXmlAttributeCheck XmlAttributeHighConfidence
      GlyphXmlChildQuestion XmlElementLowConfidence
      GlyphXmlChildCheck XmlElementHighConfidence
      GlyphXmlDescendantQuestion XmlDescendantLowConfidence
      GlyphXmlDescendantCheck XmlDescendantHighConfidence
      GlyphCompletionWarning IntellisenseWarning