Porady: tworzenie niestandardowych stron opcji

Dodatki Visual Studio zostały zaniechane w programie Visual Studio 2013.Dodatki należy uaktualniać do pakietu rozszerzenia VSPackage.Aby uzyskać więcej informacji na temat uaktualniania, zobacz Często zadawane pytania: konwertowanie dodatków na rozszerzenia pakietu VSPackage.

Okno dialogowe Opcje wyświetla różne strony dla różnych części Visual Studio.Istniejące opcje strony, można kontrolować, jak wskazano w Kontrolowanie ustawień opcji, można także tworzyć własne niestandardowe strony.Można użyć niestandardowych stron, aby pozwolić użytkownikom na zmienianie ustawień dodatków lub innych programów.

Aby utworzyć własną niestandardową stronę Opcje, nie trzeba używać dodatku, ponieważ definicja strony jest przechowywana w pliku XML, zamiast klucza rejestru.W związku z tym, można utworzyć strony Opcje, które są dostępne w zintegrowanym środowisko programistycznym (IDE) Visual Studio, a także w makrach IDE.

Następujące kroki pokazują, jak utworzyć formant użytkownika niestandardowego, który będzie pełnił rolę niestandardową strony Opcje, a następnie zmodyfikować plik .addin, aby odwoływać się do niej.

[!UWAGA]

Polecenia menu i okien dialogowych mogą różnić się od tych opisanych w Pomocy, w zależności od ustawień aktywnych lub wydania.Procedury te zostały opracowane z ogólnych ustawień projektowych active.Aby zmienić swoje ustawienia, kliknij Importuj i eksportujustawienia w menu Narzędzia.Aby uzyskać więcej informacji, zobacz Dostosowywanie ustawień środowiska deweloperskiego w Visual Studio.

Aby utworzyć niestandardowe opcje strony

1. Utwórz projekt biblioteki formantów systemu Windows.Nadaj nazwę ToolsOptionsLibrary.dll.

2. Dodaj formanty i funkcje, które chcesz.

   Ten formant użytkownika będzie niestandardową stroną Opcje.Zmienia rozmiar formantu w celu wypełnienia okna dialogowego Opcje obszaru klienckiego.

3. Kompiluj projekt.

   Visual Studio wyszukuje wszystkie pliki dodatków udostępnione podczas uruchamiania i ładuje te, które są obecne.Strona Opcje o nazwie Dodatki/Zabezpieczenia makro definiuje zestaw tokenów dla ścieżki plików do plików .addin.Uwzględnione są następujące generatory kodów:

   • %ALLUSERSPROFILE%

   • %APPDATA%

   • % USERPROFILE %

   • %VSAPPDATA%

   • %VSCOMMONAPPDATA%

   Gdy Visual Studio rozpoczyna wyszukiwanie plików dodatków, zastępuje te tokeny używając następujących ciągów ścieżki:

   Token	Ścieżka
   %ALLUSERSPROFILE%	..\Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\
   %APPDATA%	..\Documents and Settings\username\Microsoft\MSEnvShared\Addins\
   % USERPROFILE %	..\Documents and Settings\username\My Documents\Visual Studio 2010\Addins\
   %VSAPPDATA%	..\Documents and Settings\username\Addins\
   %VSCOMMONAPPDATA%	..\Documents and Settings\All Users\Addins

   Aby uzyskać więcej informacji na temat sposobu rejestrowania dodatków, zobacz Zabezpieczenia dodatków.

4. W jednym z katalogów wymienionych wcześniej, utwórz plik .addin, aby utworzyć odniesienie do nowej strony Opcje.

   Można użyć następującego kodu jako szablonu:

   <?xml version="1.0" encoding="UTF-16" standalone="no"?>
   <Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
       <HostApplication>
           <Name>Microsoft Visual Studio Macros</Name>
           <Version>10.0</Version>
       </HostApplication>
       <HostApplication>
           <Name>Microsoft Visual Studio</Name>
           <Version>10.0</Version>
       </HostApplication>
       <ToolsOptionsPage>
           <Category Name="Environment">
               <SubCategory Name="My Tools Options Page">
                   <Assembly><dll location></Assembly>
                   <FullClassName>ToolsOptionsLibrary.UserControl1
                   </FullClassName>
               </SubCategory>
           </Category>
       </ToolsOptionsPage>
   </Extensibility>
   

5. W znaczniku <Assembly></Assembly> zamień <dll location> przy użyciu ścieżki ToolsOptionsLibrary.dll.

6. Zmień ustawienia <ToolsOptionsPage> (nazwa kategorii, nazwa podkategorii i tak dalej), aby odzwierciedlić specyfikę kontroli użytkownika.

   Na przykład, jeśli formant użytkownika nazwano „NewPage”, a projekt to „MyTOLib”, wówczas znacznikiem FullClassName będzie MyTOLib.NewPage.Zestaw jest tam, gdzie znajdują się Opcje Biblioteki DLL.Nazwa kategorii jest węzłem w oknie dialogowym Opcje, w którym chcesz zlokalizować swoją niestandardową stronę, na przykład, Środowisko, Debugowanie lub Projekt.

   Jeśli określisz nazwę, która nie istnieje, zostanie utworzony węzeł, który ma taką nazwę.Podkategoria jest to nazwa widoczna w węźle.Należy zauważyć, że maksymalna liczba poziomów wynosi dwa.Nie można dodać węzła trzeciego poziomu.

7. Zapisz plik jako plik tekstowy, który ma rozszerzenie nazwy pliku .addin w jednym z folderów pliku dodatku, które opisano wcześniej.Katalogiem domyślnym jest...\Documents and Settings\username\Application Data\Microsoft\MSEnvShared\Addins\.

   Gdy Visual Studio jest uruchamiana, szuka w tym katalogu standardowej definicji strony Opcje i ładuje te, które znajdzie.Można zmienić lub dodać dodatek katalogów za pomocą strony Dodatek / Poziomu zabezpieczeń makr pod węzłem Środowisko w oknie dialogowym Opcje.

8. Rozpocznij Visual Studio i kliknij Opcje w menu Narzędzia.

   Twoja nowa strona Opcje jest wyświetlana.

Zobacz też

Zadania

Porady: zmienianie charakterystyki okna

Koncepcje

Kontrolowanie ustawień opcji

Rejestracja dodatków

Wykres modelu obiektów automatyzacji

Inne zasoby

Tworzenie i kontrolowanie okien środowiska

Odwołanie do automatyzacji i rozszerzalności