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


Создание страницы параметров с помощью автоматизации

Управляемое VSPackages может использовать автоматизацию для расширения Visual Studio интегрированная среда разработки (ide), добавляя Параметры страницы до Сервис меню.

A "Сервис параметры " страница фундаментально пользовательского элемента управления и закодирована точно так же, как любой другой пользовательский элемент управления. Обычно использовался бы одно из Visual Studio Конструкторы интегрированной среды разработки для создания объекта и добавление пользовательских элементов управления.

Примечание

"Сервис параметры " страницы, реализованные как диалоговое окно, используя a DialogProc обрабатывать сообщения windows, безрежимное быть диалоговыми окнами и вызывать EndDialog функция.

Следует использовать объект автоматизации, VSPackage предоставляет среду со свойствами пользовательского элемента управления.

Поддержка автоматизации для страниц Параметры средств, реализованных с сборками взаимодействия

Для поддержки модели автоматизации VSPackage должно создать и зарегистрировать объект автоматизации. Дополнительные сведения см. в разделе Защита модели для VSPackages.

Если код, который использует модель автоматизации вызывает DTE.Properties для коллекции свойств заданным "Сервис параметры " страница интегрированная среда разработки автоматизации использует объект, предоставленный реализацией VSPackage GetAutomationObject возвращает коллекцию и разрешить доступ к своему составу Property объекты.

Примечание.   Объект автоматизации, возвращаемый by GetAutomationObject зависит от предоставленный GUID (например VSPackage может поддерживать несколько объект автоматизации). Дополнительные сведения о реализации см. объекты автоматизации. Поддержка автоматизации для страницы параметров.

A "Сервис параметры " страница указана 2 идентификаторами. Первый идентификатор является строкой, которая отображает папку, содержащую элемент Параметры раздел Сервис меню. Второй идентификатор строка, которая указывает конкретный элемент в папке. Дополнительные сведения см. в разделе С помощью страницы параметров.

Для регистрации записи реестра. объект автоматизации: 2

  • В разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия \ Packages \<PackageGUID>\ Автоматизация

  • В разделе HKEY_LOCAL_MACHINE \ software \ microsoft \ VisualStudio \<Версия>\ AutomationProperties

    где <Версия> версия Visual Studio (например, 8,0). <PackageGUID> идентификатор GUID VSPackage, реализующий объект автоматизации.

В зависимости от конфигурации в записи реестра AutomationProperties, состояние a "Сервис параметры " страница может автоматически сохранять и восстанавливается до Visual Studio механизм параметров, когда пользователь выбирает Параметры импорта-экспорта команда на Сервис меню. Дополнительные сведения о сбережениях "Сервис параметры " настройки страницы см. в разделе Регистрация пользовательские Параметры страницы.

Приложение не может использовать модель автоматизации для реализации поддержки a "Сервис параметры " свойства и параметры страницы.

Это может быть желательно по нескольким причинам:

  • Параметры обработки "Сервис параметры " страница более сложна в структуре, чем относительно плоская модель автоматизации поддерживает свойства.

  • Необходимость предотвратить программно управлять его от других приложений "Сервис параметры " страница.

  • Специальные управления доступом или средства безопасности требуются.

В этих случаях VSPackages может реализовать "Сервис параметры " поддержка страницы в любом случае, подходящей. Однако они:

  • Настройте параметр "Сервис параметры " свойства страницы.

  • Сохраняемость управления "Сервис параметры " состояние страницы до Visual Studio параметры.

  • Обеспечьте API, при необходимости, для других приложений, применять "Сервис параметры " страница.

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

Поддержка автоматизации для страниц " сервис Параметры " в управляемом пакет .NET Framework

Установка SupportsAutomation свойство регистрация реализации ProvideOptionPageAttribute экземпляр, чтобы указать, что управляемая реализация .NET Framework-основания пакета a "Сервис параметры " страница поддерживает автоматизацию.

"Сервис параметры " страницы, производные от DialogPage предоставьте с объектом автоматизации по умолчанию, который можно переопределить.

Если набор узлов a "Сервис параметры " реализация страницы не поддерживает автоматизацию реализация должна предоставить собственное API, чтобы разрешить программный доступ к "Сервис параметры " страница.

Примечание

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

См. также

Задачи

Практическое руководство. Создание пользовательских страниц параметров

Ссылки

Создать скрипты регистратора

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

Создание страницы параметров с помощью сборок взаимодействия

Создание страницы параметров с помощью классов MPF

Поддержка автоматизации для страницы параметров

С помощью страницы параметров

Другие ресурсы

Расширение среды Visual Studio