Compartilhar via


Alterando as configurações de exibição usando a API Legacy

As configurações de recursos do editor de núcleo, como, por exemplo, quebra automática de margem de seleção e o espaço virtual, podem ser alteradas pelo usuário por meio do Opções caixa de diálogo. No entanto, também é possível alterar essas configurações por meio de programação.

Alterando as configurações usando a API Legacy

O IVsTextEditorPropertyCategoryContainer interface expõe um conjunto de propriedades do editor de texto. O modo de exibição de texto contém uma categoria de propriedades (GUID_EditPropCategory_View_MasterSettings) que representa o grupo de configurações alterados por meio de programação para a exibição de texto. Depois de exibir as configurações foram alteradas dessa maneira, eles não podem ser alterados no Opções caixa de diálogo até que sejam redefinidos.

Veja a seguir o processo típico para alterar as configurações de exibição para uma instância do editor principal.

  1. Chame QueryInterface sobre o (VsTextView) para o IVsTextEditorPropertyCategoryContainer interface.

  2. Chamar o GetPropertyCategory método, especificando um valor de GUID_EditPropCategory_View_MasterSettings para o rguidCategory parâmetro.

    Isso retorna um ponteiro para o IVsTextEditorPropertyCategoryContainer interface, que contém o conjunto de propriedades forçadas para o modo de exibição. Todas as configurações deste grupo são forçadas permanentemente. Se uma configuração não estiver nesse grupo, ele seguirá as opções especificadas no Opções caixa de diálogo ou os comandos do usuário.

  3. Chamar o SetProperty método, especificando o valor de configurações apropriadas na idprop parâmetro.

    Por exemplo, para forçar a quebra automática, chamar SetProperty e especifique um valor de VSEDITPROPID_ViewLangOpt_WordWrap, vt para o idprop parâmetro. Nesta chamada, vt é uma VARIANTE do tipo VT_BOOL e vt.boolVal é VARIANT_TRUE.

Redefinindo as configurações alteradas de modo de exibição

Para redefinir qualquer exibição alterada a definição para uma instância do editor principal, chame o RemoveProperty método e especifique o valor da configuração apropriada na idprop parâmetro.

Por exemplo, para permitir a quebra automática de flutue livremente, você deve removê-lo na categoria de propriedade chamando RemoveProperty e especificando um valor de VSEDITPROPID_ViewLangOpt_WordWrap para o idprop parâmetro.

Para remover configurações alteradas todos para o editor principal de uma só vez, especifique um valor de VSEDITPROPID_ViewComposite_AllCodeWindowDefaults, vt para o idprop parâmetro. Nesta chamada, vt é uma VARIANTE do tipo VT_BOOL e vt.boolVal é VARIANT_TRUE.

Consulte também

Referência

Caixa de diálogo Opções (Visual Studio)

Conceitos

Acessando theText modo de exibição usando a API Legacy

Outros recursos

Dentro do Editor de núcleo