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

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

  • Статья

Диалоговое окно Параметры содержит множество страниц для различных частей Visual Studio. Можно управлять существующими страницами параметров, как это описано в разделе Управление параметрами, а также создавать собственные пользовательские страницы. Пользовательские страницы могут разрешить пользователям изменять параметры надстройки или других программ.

Для создания собственной настраиваемой страницы Параметры использование надстройки не требуется, так как определение страницы хранится в файле XML в отличие от значений реестра. Это позволяет создавать страницы параметров, доступные в среде IDE Visual Studio, а также в среде Macros IDE.

Ниже демонстрируется создание настраиваемого пользовательского элемента управления, который будет играть роль пользовательской страницы Параметры, и последующее изменение файла ADDIN для ссылки на него.

Примечание

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от текущих настроек или выпуска.Эти процедуры были разработаны с обычными параметрами разработки.Чтобы изменить параметры, выберите команду Импорт и экспортпараметров в меню Сервис.Дополнительные сведения см. в разделе Работа с параметрами.

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

  1. Создайте проект "Библиотека элементов управления Windows". Назовите его ToolsOptionsLibrary.dll.

  2. Добавьте необходимые элементы управления и функции.

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

  3. Выполните построение проекта.

    При запуске Visual Studio выполняет поиск всех общих файлов ADDIN и загрузку имеющихся. Страница Параметры с именем Безопасность надстроек и макросов определяет набор токенов для путей к файлам ADDIN. Включены следующие маркеры:

    • %ALLUSERSPROFILE%

    • %APPDATA%

    • %USERPROFILE%

    • %VSAPPDATA%

    • %VSCOMMONAPPDATA%

    Когда Visual Studio начинает поиск файлов ADDIN, эти токены заменяются следующими строками пути:

    Токен

    Путь

    %ALLUSERSPROFILE%

    .. \Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\

    %APPDATA%

    .. \Documents and Settings\имя_пользователя\Microsoft\MSEnvShared\Addins\

    %USERPROFILE%

    .. \Documents and Settings\имя_пользователя\My Documents\Visual Studio 2010\Addins\

    %VSAPPDATA%

    .. \Documents and Settings\имя_пользователя\Addins\

    %VSCOMMONAPPDATA%

    .. \Documents and Settings\All Users\Addins

    Дополнительные сведения о регистрации надстроек см. в разделе Безопасность надстроек.

  4. Создайте файл ADDIN в одном из указанных каталогов, чтобы создать ссылку на страницу Параметры.

    В качестве образца можно использовать следующий код.

    <?xml version="1.0" encoding="UTF-16" standalone="no"?>
<Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
    <HostApplication>
        <Name>Microsoft Visual Studio Macros</Name>
        <Version>10.0</Version>
    </HostApplication>
    <HostApplication>
        <Name>Microsoft Visual Studio</Name>
        <Version>10.0</Version>
    </HostApplication>
    <ToolsOptionsPage>
        <Category Name="Environment">
            <SubCategory Name="My Tools Options Page">
                <Assembly><dll location></Assembly>
                <FullClassName>ToolsOptionsLibrary.UserControl1
                </FullClassName>
            </SubCategory>
        </Category>
    </ToolsOptionsPage>
</Extensibility>

  5. В теге <Assembly></Assembly> замените <dll location> на путь к ToolsOptionsLibrary.dll.

  6. Замените параметры <ToolsOptionsPage> ("Имя категории", "Имя подкатегории" и т. д.) в соответствии со спецификой пользовательского элемента управления.

    Например, если элемент управления назван "NewPage", а его проект имеет имя "MyTOLib", то тег FullClassName будет выглядеть следующим образом: "MyTOLib.NewPage". Сборка представляет собой расположение файла параметров DLL. Имя категории представляет собой узел диалогового окна Параметры, в котором будет располагаться настраиваемая страница (например, "Среда", "Отладка" или "Проекты").

    Если указано несуществующее имя, то будет создан узел с таким именем. Подкатегория — это имя, отображаемое под узлом. Обратите внимание на то, что возможно максимум два узла. Добавление узла третьего уровня невозможно.

  7. Сохраните файл в виде текстового файла с расширением ADDIN в одной из описанных выше папок. Каталог по умолчанию: \Documents and Settings\имя_пользователя\Application Data\Microsoft\MSEnvShared\Addins\.

    При запуске Visual Studio в этом каталоге выполняется поиск определений настраиваемых страниц Параметры. Найденные страницы загружаются. Добавление и изменение каталогов надстроек выполняется на странице Безопасность надстроек и макросов в узле Среда диалогового окна Параметры.

  8. В среде Visual Studio выберите команду Параметры в меню Сервис.

    Отобразится созданная страница Параметры.

См. также

Задачи

Практическое руководство. Изменение параметров окон

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

Управление параметрами

Регистрация надстройки

Диаграмма модели объектов автоматизации

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

Создание окон среды и управление ими

Справочник по автоматизации и возможностям расширения среды