Udostępnij za pośrednictwem


Dodawanie paska narzędzi

W tym przewodniku pokazano, jak dodać pasek narzędzi do środowiska IDE programu Visual Studio.

Pasek narzędzi to poziomy lub pionowy pasek zawierający przyciski powiązane z poleceniami. W zależności od jego implementacji pasek narzędzi w środowisku IDE może być zmieniany, zadokowany po dowolnej stronie głównego okna ide lub wykonany, aby pozostać przed innymi oknami.

Ponadto użytkownicy mogą dodawać polecenia do paska narzędzi lub usuwać je z niego przy użyciu okna dialogowego Dostosowywanie . Zazwyczaj paski narzędzi w pakietach VSPackage można dostosowywać przez użytkownika. Środowisko IDE obsługuje wszystkie dostosowania, a pakiet VSPackage odpowiada na polecenia. Pakiet VSPackage nie musi wiedzieć, gdzie znajduje się polecenie fizycznie.

Aby uzyskać więcej informacji na temat menu, zobacz Polecenia, menu i paski narzędzi.

Tworzenie rozszerzenia z paskiem narzędzi

Utwórz projekt VSIX o nazwie IDEToolbar. Dodaj szablon elementu polecenia menu o nazwie ToolbarTestCommand. Aby uzyskać informacje o tym, jak to zrobić, zobacz Create an extension with a menu command (Tworzenie rozszerzenia za pomocą polecenia menu).

Tworzenie paska narzędzi dla środowiska IDE

  1. W pliku ToolbarTestCommandPackage.vsct wyszukaj sekcję Symbole. W elemecie GuidSymbol o nazwie guidToolbarTestCommandPackageCmdSet dodaj deklaracje dla paska narzędzi i grupy pasków narzędzi w następujący sposób.

    <IDSymbol name="Toolbar" value="0x1000" />
    <IDSymbol name="ToolbarGroup" value="0x1050" />
    
  2. W górnej części sekcji Polecenia utwórz sekcję Menu. Dodaj element Menu do sekcji Menu, aby zdefiniować pasek narzędzi.

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

    Nie można zagnieżdżać pasków narzędzi, takich jak podmenu. W związku z tym nie trzeba przypisywać grupy nadrzędnej. Ponadto nie trzeba ustawiać priorytetu, ponieważ użytkownik może przenosić paski narzędzi. Zazwyczaj początkowe umieszczanie paska narzędzi jest definiowane programowo, ale kolejne zmiany przez użytkownika są utrwalane.

  3. W sekcji Grupy po istniejącym wpisie grupy zdefiniuj element Grupuj, aby zawierał polecenia paska narzędzi.

    <Group guid="guidToolbarTestCommandPackageCmdSet" id="ToolbarGroup" priority="0x0000">
        <Parent guid="guidToolbarTestCommandPackageCmdSet" id="Toolbar" />
    </Group>
    
  4. Ustaw przycisk na pasku narzędzi. W sekcji Przyciski zastąp blok Nadrzędny na pasku narzędzi Przycisk. Wynikowy blok Przycisk powinien wyglądać następująco:

    <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>
    

    Domyślnie, jeśli pasek narzędzi nie ma żadnych poleceń, nie jest wyświetlany.

  5. Skompiluj projekt i rozpocznij debugowanie. Powinno zostać wyświetlone wystąpienie eksperymentalne.

  6. Kliknij prawym przyciskiem myszy pasek menu programu Visual Studio, aby pobrać listę pasków narzędzi. Wybierz pozycję Test — pasek narzędzi.

  7. Pasek narzędzi powinien być teraz widoczny jako ikona po prawej stronie ikony Znajdź w plikach. Po kliknięciu ikony powinno zostać wyświetlone okno komunikatu z komunikatem ToolbarTestCommandPackage. Wewnątrz IDEToolbar.ToolbarTestCommand.MenuItemCallback().