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

Пошаговое руководство: Добавление панели инструментов в окно инструментов

  • Статья

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

Панель инструментов горизонтальную или вертикальную прокладка, содержащей кнопки привязанные к командам. Длина панели инструментов в окне инструментов всегда такое же, как ширина или высота окна инструментов, в зависимости от того, где панель инструментов закреплена.

На панели инструментов в окне инструментов не создаются автоматически интегрированной средой разработки (ide). Они должны добавляться программно VSPackage, создается окно инструментов.

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

Дополнительные сведения о том, как добавлять панели инструментов в интегрированной среде разработки см. в разделе Пошаговое руководство. Добавление панели инструментов в IDE.

Обязательные компоненты

Чтобы выполнить это пошаговое руководство, необходимо устанавливать SDK для Visual Studio 2010.

Примечание

Дополнительные сведения о пакете SDK для Visual Studio см. в разделе интеграция SDK Visual Studio.Чтобы узнать, как загрузить пакет SDK для Visual Studio см. в разделе Центр разработчиков расширяемости Visual Studio на веб-сайте MSDN.

Расположения для шаблона проекта пакета Visual Studio

Шаблон проекта пакета Visual Studio в выпуске 3 местах в Создать проект диалоговое окно:

  • Под расширяемость Visual Basic. Язык по умолчанию для проекта Visual Basic.

  • Под Расширяемость C#. Язык по умолчанию для проекта c#.

  • Под Другие типы проектов расширяемости. Язык по умолчанию для проекта C++.

Создание VSPackage для окна инструментов

Этот раздел демонстрирует использование Visual Studio Шаблон проекта для создания пакета VSPackage окно инструментов, которое поддерживает только одну команду меню.

Создание TWToolbar VSPackage

  1. Создайте именованное VSPackage TWПанель инструментов. Дополнительные сведения см. в разделе Пошаговое руководство: Создание команды меню ресурсов с помощью шаблона пакета Visual Studio.

  2. Установите язык программирования с Visual Basic OR **Visual c#**и выберите Команда меню и Окно инструментов параметры.

  3. Под Параметры командызадайте имя команды команда TWTestи идентификатор команды cmdidTWTestCmd.

  4. Под Параметры окна инструментовзадайте имя окна в окно инструментов тестаи идентификатор команды cmdidTestTool.

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

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

  1. Откройте TWToolbar.vsct в текстовом редакторе.

  2. в Symbols в раздел " GuidSymbol "guidTWToolbarCmdSet" именованное узлом, объявляющий панель инструментов и группу панели инструментов следующим образом.

    <IDSymbol name="TWToolbar" value="0x1000" />
<IDSymbol name="TWToolbarGroup" value="0x1050" />

  3. В начало Commands раздел создает a Menus раздел.

    <Menus></Menus>

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

  4. Add a Menu элемент Menus раздел, чтобы указать на панели инструментов.

    <Menu guid="guidTWToolbarCmdSet" id="TWToolbar" type="ToolWindowToolbar">
  <CommandFlag>DefaultDocked</CommandFlag>
  <Strings>
    <ButtonText>Test Toolbar</ButtonText>
    <CommandName>Test Toolbar</CommandName>
  </Strings>
</Menu>

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

  5. в Groups раздел записи, после существующей группы, указывающее группу для хранения команд на панели инструментов.

    <Group guid="guidTWToolbarCmdSet" id="TWToolbarGroup" priority="0x0000">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbar" />
</Group>

  6. в Buttons раздел, изменяется родительский существовать Button элемент в группе панели инструментов так как панель инструментов отображается.

    <Button guid="guidTWToolbarCmdSet" id="cmdidTWTestCommand" priority="0x0100" type="Button">
  <Parent guid="guidTWToolbarCmdSet" id="TWToolbarGroup" />
  <Icon guid="guidImages" id="bmpPic1" />
  <Strings>
    <CommandName>cmdidTWTestCmd</CommandName>
    <ButtonText>TWTest Command</ButtonText>
  </Strings>
</Button>

    По умолчанию, если панель инструментов отсутствуют команды, она не появляется.

    Так как новая панель инструментов не добавляется автоматически в окно инструментов Visual Studio Интегрированная среда разработки панель инструментов должна быть добавлена сама программно VSPackage. Это описано в следующем подразделе "добавление панели инструментов в окно инструментов".

Добавление панели инструментов окна инструментов

Добавление панели инструментов окна инструментов

  1. В проекте TWToolbar, откройте PkgCmdID.vb или PkgCmdID.cs в текстовом редакторе.

  2. После существующих идентификаторы команд в файле PkgCmdID добавьте следующее идентификатор команды.

    public const int TWToolbar = 0x1000;

  3. Откройте MyToolWindow.vb или MyToolWindow.cs в текстовом редакторе.

  4. В верхней части файла, после другого Imports OR using выписки, добавить следующую линия.

    using System.ComponentModel.Design; // for CommandID

  5. в MyToolWindow конструктор класса, в начале конструктора добавьте следующий линия.

    this.ToolBar = new CommandID(
    GuidList.guidTWToolbarCmdSet,
    PkgCmdIDList.TWToolbar);

    Этот код указывает, что управляемый рамкам пакета (MPF), панель инструментов создается, если окно инструментов будет создано.

    Примечание

    В управляемом коде только одна панель инструментов можно добавить в окно инструментов.

  6. В меню Построение выберите команду Построить решение, чтобы выполнить построение решения.

Тестирование панели инструментов в окне инструментов

Тестирование панели инструментов в окне инструментов

  1. Нажмите клавишу F5, чтобы открыть экземпляр экспериментальном Visual Studio в режиме отладки.

  2. На Просмотреть меню наведите курсор на пункт Другие окна затем перейдите окно инструментов теста отобразить окно инструментов.

    Обратите внимание, что панель инструментов отображается только под заголовком окна инструментов.

  3. На панели инструментов окна инструментов нажмите значок для отображения сообщения "в Company.TWToolbar.TWToolbarPackage.MenuItemCallback()".

См. также

Задачи

Пошаговое руководство. Добавление панели инструментов в IDE

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

Пошаговые руководства, для команд меню, панелей инструментов

Команды, меню, панели инструментов