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

Статья
11/05/2008

Обновлен: Ноябрь 2007

Можно изменить значок по умолчанию, который Visual Studio связывает с пунктом меню для надстройки, созданной на основе типа проекта надстройки Visual Studio.

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

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

Первый способ — просто изменить порядковый номер значка по умолчанию (59) на номер другого стандартного значка в сборке Microsoft.VisualStudio.CommandBars, содержащей около 3000 значков. Второй вариант — определить собственное растровое изображение, такое как логотип компании или пользовательский значок, добавить его в качестве ресурса во вспомогательную библиотеку DLL, а затем изменить код надстройки, указав на новый точечный рисунок. Первый вариант проще и быстрее, но предусматривает использование ограниченного числа значков в Microsoft.VisualStudio.CommandBars. Второй способ требует больше усилий, но позволит использовать именно необходимый значок.

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

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

Чтобы изменить значок по умолчанию на другой стандартный значок

Откройте решение, созданное Мастером надстроек.

В событии 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. При запуске надстройки команда в меню Сервис будет выводиться рядом со значком красной звезды.

Полный список доступных стандартных значков см. на странице Поиск номеров значков для панелей инструментов Microsoft Office 97. В этой статье в библиотеке MSDN можно найти небольшое приложение, позволяющее просмотреть все значки и узнать их номера так, чтобы можно было выбрать необходимый значок.

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

Примечание.
На узле Образцы автоматизации Visual Studio имеется загружаемый пример проекта, демонстрирующий выполнение этой задачи в Visual Basic и Visual C#. Щелкните ссылку "Надстройка с пользовательским растровым изображением".

См. также

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

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

Чтобы изменить значок по умолчанию на другой стандартный значок

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы