Поделиться через


Реализация пользовательских категорий и папок отображения

VSPackage может реализовать элемент управления шрифтов и цветов его текст Visual Studio интегрированная среда разработки (ide) с помощью пользовательских категорий и папки отображения.

Пользовательские категории и папок отображения на Шрифты и цвета страница свойств. Открыть Шрифты и цвета страница свойств на Сервис меню выберите команду Параметры. Развернуть Среда затем перейдите Шрифты и цвета.

При использовании этого механизма, VSPackages должен реализовать IVsFontAndColorDefaultsProvider интерфейс и связанные с ним интерфейсы.

В принципе, этот механизм может использоваться для изменения все имеющееся Отображаемые элементы и Категории содержит их. Однако он не должен использоваться для изменения Текстовый редакторКатегория или сво Отображаемые элементы. Дополнительные сведения см. в разделе Общие сведения о шрифтов и цветов.

На пользовательские " Категории OR Отображаемые элементыв VSPackage.

  • Создайте или определите категории в реестре.

    Реализация интегрированной среды разработки Шрифты и цвета страница свойств использует эти сведения, чтобы правильно запросить службы поддержки данной категории.

  • Создайте или определите группы (необязательно) в реестре.

    Может быть полезно указать группу, представляющий собой объединение двух или более категорий. Если группа указана, интегрированная среда разработки автоматически выполняет слияние подкатегории и распределяет папке отображения, входящих в группу.

  • Реализовать поддержку интегрированной среды разработки.

  • Обработка изменения шрифта и цвета.

Дополнительные сведения см. в разделе Доступ к, сохраненной параметры шрифта и цвета.

Создание или задать категории

  • Построение - это специальный тип записи реестра категории вниз [HKLM \ software \ microsoft \ Visual Studio \<версия Visual Studio>\ \ FontAndColors<Category>]

    <Category> нелокализованное имя категории.

  • Заполните реестр с 2 значениями:

    Имя

    Тип

    Данные

    Описание

    Категория

    REG_SZ

    GUID

    Идентификатор GUID, созданное для указания категории.

    Пакет

    REG_SZ

    GUID

    Идентификатор GUID службы VSPackage, которая поддерживает категорию.

Служба, указанная в реестре должна обеспечивать реализацию IVsFontAndColorDefaults для соответствующей категории.

Создание или определить Группы

  • Построение - это специальный тип записи реестра категории вниз [HKLM \ software \ microsoft \ Visual Studio \<версия Visual Studio>\ \ FontAndColors<группа>]

    <group> нелокализованное имя группы.

  • Заполните реестр с 2 значениями:

    Имя

    Тип

    Данные

    Описание

    Категория

    REG_SZ

    GUID

    Идентификатор GUID, созданное для определения группу.

    Пакет

    REG_SZ

    GUID

    Идентификатор GUID службы, которая поддерживает категорию.

Служба, указанная в реестре должна обеспечивать реализацию T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup для соответствующей группы.

Реализовать поддержку интегрированной среды разработки

  • Реализация GetObjectто, который возвращает IVsFontAndColorDefaults интерфейс или T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup интерфейс к интегрированной среде разработки для каждого Категория или предоставленный идентификатор GUID группы.

  • Для каждого Категория она поддерживает VSPackage реализуется отдельный экземпляр IVsFontAndColorDefaults интерфейс.

  • Методы, реализованные с помощью инструкций IVsFontAndColorDefaults предоставить интегрированную среду разработки:

    • Списки Отображаемые элементы в категория.

    • Локализуемое имена Отображаемые элементы.

    • Сведения об отображении для каждого члена Категория.

    Примечание

    Каждые Категория содержаться хотя бы одно папка отображения.

  • Интегрированная среда разработки использует T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup интерфейс, чтобы определить объединение нескольких категорий.

    Реализация обеспечивает интегрированную среду разработки:

    • Список Категории он состоит из заданной группы.

    • Доступ к экземплярам IVsFontAndColorDefaults сохранить все Категория в группу.

    • Локализуемое имена групп.

  • Обновление интегрированная среда разработки:

    Интегрированная среда разработки кэширует сведения о кэшированных Шрифт и цвет параметры. Поэтому после любого изменения интегрированной среды разработки Шрифт и цвет конфигурация рекомендуется убедиться, что кэш актуален.

Обновление кэша выполняется посредством IVsFontAndColorCacheManager интерфейс и могут выполняться глобально или только для выбранных элементов.

Обрабатывать изменения шрифта и цвета

Для правильной поддержки колоризацию текст, VSPackage указывающее, поддержка колоризации VSPackage должна реагировать на изменения, сделанные через пользователь-начатым Шрифты и цвета страница свойств. VSPackage делается следующим образом.

  • Обработка Интегрированная среда разработки-произведенные события путем реализации IVsFontAndColorEvents интерфейс.

    Интегрированная среда разработки вызывает соответствующий метод после изменений пользователя Шрифты и цвета страница. Например, он вызывает OnFontChanged метод если новый шрифт выделен.

    -или-

  • Опрос интегрированная среда разработки изменений.

    Это можно сделать с помощью система-снабженное IVsFontAndColorStorage интерфейс. Хотя в основном для поддержки сохраняемости, GetItem метод можно использовать для получения сведений о шрифта и цвета для Отображаемые элементы. Дополнительные сведения см. в разделе Доступ к, сохраненной параметры шрифта и цвета.

    Примечание

    Чтобы убедиться, что результаты, полученные с помощью опросов верны, может быть полезно использовать IVsFontAndColorCacheManager интерфейс, чтобы определить, записывать на диск и обновление кэша до вызова методов для возврата IVsFontAndColorStorage интерфейс.

См. также

Задачи

Практическое руководство. Доступ к их встроенные и цветовая схема

Ссылки

QueryService

IVsFontAndColorDefaults

IVsFontAndColorEvents

IVsFontAndColorStorage

IVsFontAndColorGroup

IVsFontAndColorDefaultsProvider

Основные понятия

Получение сведений о шрифтов и цветов для колоризации текста

Доступ к, сохраненной параметры шрифта и цвета

Общие сведения о шрифтов и цветов