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


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

Значок, связанный с командой меню для надстройки, которая создана на основе типа проекта "Надстройка" Visual Studio, можно изменить.Чтобы найти тип проекта "Надстройка", в диалоговом окне Создать проект разверните узел Другие типы проектов и щелкните элемент Проекты расширения среды.

При создании надстройки на основе типа проекта "Надстройка" в Мастере надстроек можно добавить пользовательский интерфейс для настройки, установив флажок Создать интерфейс панели команд для надстройки?.

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

  • Изменить порядковый номер значка (59 в случае значка по умолчанию) на номер другого значка в сборке Microsoft.VisualStudio.CommandBars.Сборка содержит почти 3000 значков.

  • Определить собственное растровое изображение, например логотип компании, скомпилировать его в виде ресурса во вспомогательную библиотеку DLL, а затем изменить код надстройки, указав на новое растровое изображение.

Первый способ быстрее, однако он позволяет использовать только значки из сборки Microsoft.VisualStudio.CommandBars.Второй способ позволяет использовать любой значок.

ПримечаниеПримечание

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

Изменение текущего значка на другой значок

  1. Откройте решение, созданное на основе типа проекта "Надстройка".

  2. В файле проекта в методе OnConnection найдите следующую строку.

    command = commands.AddNamedCommand2(_addInInstance, _
      "MyAddin1", "MyAddin1",  _
      "Executes the command for MyAddin1", True, 59, Nothing, _
      CType(vsCommandStatus.vsCommandStatusSupported, _
       Integer) + 
       CType(vsCommandStatus.vsCommandStatusEnabled, _
       Integer), vsCommandStyle.vsCommandStylePictAndText, _
       vsCommandControlType.vsCommandControlTypeButton)
    
    Command command = commands.AddNamedCommand2(_addInInstance, 
    "MyAddin1", "MyAddin1", "Executes the command for MyAddin1", 
    true, 59, ref contextGUIDS, (int)vsCommandStatus.
    vsCommandStatusSupported+(int)vsCommandStatus.
    vsCommandStatusEnabled, (int)vsCommandStyle.
    vsCommandStylePictAndText, vsCommandControlType
    .vsCommandControlTypeButton);
    

    Обратите внимание на число 59 в вызове метода AddNamedCommand2.Это порядковый номер текущего значка.Чтобы выбрать другой стандартный значок, измените этот номер.Например, чтобы выбрать значок красной звезды, измените 59 на 6743.При запуске надстройки рядом с командой в меню Сервис будет присутствовать значок красной звезды.

    Дополнительные сведения о поиске номеров идентификатора для стандартных значков см. в разделе Listing Button Faces in the Command Bar for the Microsoft Office System на веб-сайте MSDN.

  3. Если найти подходящий значок в библиотеке Microsoft.VisualStudio.CommandBars не удается, можно использовать собственное растровое изображение.Скомпилируйте растровое изображение в виде ресурса во вспомогательную библиотеку DLL.Дополнительные сведения см. в разделе Практическое руководство. Отображение пользовательского значка на кнопке надстройки.После создания ресурса во вспомогательной библиотеке DLL укажите на него в методе AddNamedCommand2.

См. также

Задачи

Практическое руководство. Управление надстройками с помощью диспетчера надстроек

Практическое руководство. Создание надстройки

Пошаговое руководство. Создание мастера

Ссылки

Команды и переключатели Visual Studio

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

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

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

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

Создание надстроек и мастеров