How to: CriarOpçõesde PersonalizarPáginas

  • Artigo

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 em ControlandoConfiguraçõesde 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 a alterar as configurações para o seus add-ins 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) do 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 ele.

ObservaçãoObservaçã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 as configurações, clique em importação e exportação configurações sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

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

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

  2. Adicione os controles e a funcionalidade desejada.

    O 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 todos os arquivos de 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 de AddIn. Os símbolos a seguir estão incluídos:

    • % ALLUSERSPROFILE %

    • % APPDATA %

    • % USERPROFILE %

    • % VSAPPDATA %

    • % VSCOMMONAPPDATA %

    Quando Visual Studio começa procurando os 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árioDocumentos\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 Adicionar-Na segurança.

  4. Em um dos diretórios listados anteriormente, criar 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" seu projeto é "mytolib" e a marca de FullClassName seria MyTOLib.NewPage. O Assembly é onde se encontra a DLL de opções. O nome da categoria é o nó de 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. Não é possível 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 / Segurança de Macros página sob o ambiente nó a 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

How to: Alterar Características da janela

Conceitos

ControlandoConfiguraçõesde Opções

Adicionar-No registro

Automation Object Model Chart

Outros recursos

Criar e controlar o ambiente Windows

Automation and Extensibility Reference