Como: criar páginas de opções personalizadas

O Opções caixa de diálogo exibe uma variedade de páginas para diferentes partes do Visual Studio.Você pode controlar as páginas de opções existentes, conforme descrito no Controlando as configurações de opções, e você também pode criar suas próprias páginas personalizadas.Você pode usar páginas personalizadas para permitir aos usuários alterar as configurações de seus suplementos ou outros programas.

Para criar seu próprio personalizada Opções página, você não precisará usar um suplemento porque a definição da página é armazenada em um arquivo XML em vez das chaves do registro.Conseqüentemente, você pode criar Opções páginas que são acessíveis no ambiente de desenvolvimento integrado (IDE) Visual Studio e também em Macros IDE.

As etapas a seguir demonstra como criar um controle de usuário personalizada que atuará como um personalizado Opções da página e, em seguida, modificar um arquivo. AddIn para fazer referência a ela.

Observação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição.Esses procedimentos foram desenvolvidos com o General Development Settings ativo.Para alterar suas configurações, clique em a importação e exportaçãoconfigurações sobre o Ferramentas menu.Para obter mais informações, consulte Configurações de Visual Studio.

Para criar uma página de opções personalizada

1. Crie um projeto de biblioteca de controle do Windows.O nome de ToolsOptionsLibrary.dll.

2. Adicione os controles e a funcionalidade que você deseja.

   Esse controle de usuário se tornará personalizada Opções página.Redimensionar o controle para preencher o Opções área cliente da caixa de diálogo.

3. Crie o projeto.

   Visual Studioprocura por todos os arquivos. AddIn compartilhada quando ele inicia e carrega os que estão presentes.O Opções página chamada Macros/adicionar segurança define um conjunto de tokens para caminhos de arquivo dos arquivos. AddIn.Os símbolos a seguir estão incluídos:

   • % ALLUSERSPROFILE %

   • % APPDATA %

   • % USERPROFILE %

   • % VSAPPDATA %

   • % VSCOMMONAPPDATA %

   Quando Visual Studio começa a procurar pelos arquivos. AddIn, ele substitui esses tokens usando as seguintes seqüências de caminho:

   Token	Caminho
   % ALLUSERSPROFILE %	..\Documents and Settings\All Data\Microsoft\MSEnvShared\Addins\ de Users\Application
   % APPDATA %	..\Documents and Settings \nome de usuário\Microsoft\MSEnvShared\Addins\
   % USERPROFILE %	..\Documents and Settings \nome de usuário\Meus Documentos\Visual Studio 2010\Addins\
   % VSAPPDATA %	..\Documents and Settings \nome de usuário\Addins\
   % VSCOMMONAPPDATA %	..\Documents and Settings\All Users\Addins

   Para obter mais informações sobre como registrar o add-ins, consulte Suplemento de segurança.

4. Em um dos diretórios listados anteriormente, crie um arquivo. AddIn para fazer referência a nova Opções página.

   Você pode usar o código a seguir como modelo:

   <?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. No <Assembly></Assembly> de marca, substitua <dll location> usando o caminho de ToolsOptionsLibrary.dll.

6. Alterar o <ToolsOptionsPage> configurações (nome da categoria, nome da subcategoria e assim por diante) para refletir as especificidades de seu controle de usuário.

   Por exemplo, se o controle de usuário é chamado de "NewPage" e seu projeto é "MyTOLib", a marca de FullClassName seria MyTOLib.NewPage.O Assembly é onde se encontra a DLL de opções.O nome da categoria é o nó a Opções caixa de diálogo onde você deseja localizar sua página personalizada, por exemplo, ambiente, depuração ou projetos.

   Se você especificar um nome que não existe, um nó que possui esse nome é criado.A subcategoria é o nome que aparece sob o nó.Observe que o número máximo de níveis é dois.Você não pode adicionar um nó de terceiro nível.

7. Salve o arquivo como um arquivo de texto que possui a extensão de nome de arquivo. AddIn, em uma das pastas de arquivo de suplemento descritas anteriormente.O diretório padrão é..\Documents and Settings \nome de usuário\Application Data\Microsoft\MSEnvShared\Addins\.

   Quando Visual Studio é iniciado, ele procura nesse diretório para custom Opções página de definições e carrega que forem encontrados.Você pode alterar ou adicionar o suplemento de diretórios usando o Add-in / A segurança de Macros página sob o ambiente nó na Opções caixa de diálogo.

8. Iniciar Visual Studio e clique em Opções sobre o Ferramentas menu.

   Sua nova Opções página é exibida.

Consulte também

Tarefas

Como: alterar as características da janela

Conceitos

Controlando as configurações de opções

Registro do suplemento

Gráfico de modelo de objeto de automação

Outros recursos

Criar e controlar o ambiente Windows

Automação e extensibilidade referência