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


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

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

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

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

Дополнительные сведения о меню см. в разделе "Команды", "Меню" и "Панели инструментов".

Создание расширения с помощью панели инструментов

Создайте проект VSIX с именем IDEToolbar. Добавьте шаблон элемента команды меню с именем ToolbarTestCommand. Сведения о том, как это сделать, см. в разделе "Создание расширения" с помощью команды меню.

Создание панели инструментов для интегрированной среды разработки

  1. В Панели инструментовTestCommandPackage.vsct найдите раздел "Символы". В элементе GuidSymbol с именем guidToolbarTestCommandPackageCmdSet добавьте объявления для панели инструментов и группы инструментов, как показано ниже.

    <IDSymbol name="Toolbar" value="0x1000" />
    <IDSymbol name="ToolbarGroup" value="0x1050" />
    
  2. В верхней части раздела "Команды" создайте раздел меню. Добавьте элемент Menu в раздел "Меню", чтобы определить панель инструментов.

    <Menus>
        <Menu guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" type="Toolbar">
            <CommandFlag>DefaultDocked</CommandFlag>
            <Strings>
                <ButtonText>Test Toolbar</ButtonText>
                <CommandName>Test Toolbar</CommandName>
            </Strings>
        </Menu>
    </Menus>
    

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

  3. В разделе "Группы" после существующей записи группы определите элемент Group, содержащий команды для панели инструментов.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" priority="0x0000">
        <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" />
    </Group>
    
  4. Нажмите кнопку на панели инструментов. В разделе "Кнопки" замените родительский блок на панель инструментов. Результирующий блок кнопки должен выглядеть следующим образом:

    <Button guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarTestCommandId" priority="0x0100" type="Button">
        <Parent guid= "guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" />
        <Icon guid="guidImages" id="bmpPic1" />
        <Strings>
            <ButtonText>Invoke ToolbarTestCommand</ButtonText>
        </Strings>
    </Button>
    

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

  5. Выполните сборку решения и запустите отладку. Должен появиться экспериментальный экземпляр.

  6. Щелкните правой кнопкой мыши строку меню Visual Studio, чтобы получить список панелей инструментов. Выберите " Тестовая панель инструментов".

  7. Теперь вы увидите панель инструментов как значок справа от значка "Найти в файлах". Щелкнув значок, вы увидите окно сообщения с надписью ToolbarTestCommandPackage. Внутри IDEToolbar.ToolbarTestCommand.MenuItemCallback().