Personalizar itens Colorable

Artigo
05/18/2015

Você pode substituir a lista de tipos para colorir, como, por exemplo, palavras-chave e comentários, Implementando os itens personalizados de colorable como parte do seu serviço de linguagem.

Configurações de usuário de itens Colorable

Você pode exibir o fontes e cores caixa de diálogo, selecionando Opções sobre o Ferramentas menu e, em seguida, selecionando fontes e cores em ambiente. Quando você seleciona uma exibição, como Editor de texto ou Janela de comando, o Exibir itens caixa de listagem mostra todos os itens colorable que exibem. Você pode exibir e alterar a fonte, tamanho, cor de primeiro plano e cor de plano de fundo para cada item colorable. Suas escolhas são armazenadas em cache no registro e acessadas pelo nome do item colorable.

Apresentação dos itens Colorable

Porque o IDE manipula substituições do usuário dos itens colorable a fontes e cores caixa de diálogo, você precisa apenas fornecer a cada item colorable personalizado com um nome. Esse nome é o que aparece no Exibir itens lista. Os itens colorable aparecem em ordem alfabética. Para agrupar itens de colorable do seu serviço de idioma personalizada, você pode começar cada nome com o seu nome de idioma, por exemplo NewLanguage - comentário e NewLanguage - a palavra-chave.

Aviso

Você deve incluir o nome do idioma no nome do item colorable para evitar colisões com nomes de colorable de item existentes.Se você alterar o nome de um dos seus itens colorable durante o desenvolvimento, você deve redefinir o cache do que foi criado na primeira vez em que os itens colorable foram acessados.Você pode redefinir o cache experimental com a ferramenta vsregex.Use a linha de comando vsregex GetOrig 10.0 Exp, substituindo a extensão de nome de versão e do Registro apropriada para sua versão do Visual Studio.A ferramenta de vsregex é instalada com o SDK do Visual Studio.Para obter mais informações sobre vsregex, consulte o tópico "A linha de comando VsRegEx" em Instância experimental do Visual Studio.

O primeiro item na sua lista de itens colorable nunca é referenciado. O primeiro item corresponde a um índice de colorable item 0, e Visual Studio sempre fornece as cores padrão de texto e os atributos desse item. A maneira mais fácil de lidar com este item não referenciado é fornecer um item de colorable de espaço reservado em sua lista como o primeiro item.

Implementação personalizada de itens Colorable

Defina o que deve ser colorido no seu idioma, por exemplo o palavra-chave, o operador e o identificador.
Crie uma enumeração desses itens colorable.
Associe os tipos de token retornados de um analisador ou um scanner com os valores enumerados.

Por exemplo, os valores que representam os tipos de token poderiam ser os mesmos valores na enumeração colorable de itens personalizados.
Na sua implementação da ColorizeLine método no seu IVsColorizer de objeto, preencher a lista de atributos por valores da enumeração colorable de itens personalizados correspondentes aos tipos de token retornados do analisador ou do scanner.
Na mesma classe que implementa o IVsLanguageInfo interface, implementar a IVsProvideColorableItems interface e seus dois métodos, GetItemCount e GetColorableItem.
Implementar a interface IVsColorableItem.
Se você quiser suportar valores de cores de 24 bits ou alta, também implementar a IVsHiColorItem interface.
No seu objeto de serviço de linguagem, crie uma lista que contém o IVsColorableItem objetos, uma para cada item colorable analisador ou o scanner pode identificar.

Você pode acessar cada item na lista, usando o valor correspondente da enumeração colorable de itens personalizados. Use os valores de enumeração como um índice para a lista. O primeiro item na lista nunca será acessado, pois ele corresponde ao texto padrão de estilos que Visual Studio sempre lida consigo mesmo. Você pode compensar isso, inserindo um item de colorable de espaço reservado no início de sua lista.
Na sua implementação da GetItemCount método, retornar o número de itens na sua lista de itens personalizados de colorable.
Na sua implementação da GetColorableItem método, retornar o item solicitado de colorable da sua lista.