LanguagePreferences Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Importante
Esta API não está em conformidade com CLS.
Fornece suporte para preferências específicas de serviço de linguagem.
public ref class LanguagePreferences : IDisposable, Microsoft::VisualStudio::TextManager::Interop::IVsTextManagerEvents2
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Runtime.InteropServices.Guid("934a92fd-b63a-49c7-9284-11aec8c1e03f")]
public class LanguagePreferences : IDisposable, Microsoft.VisualStudio.TextManager.Interop.IVsTextManagerEvents2
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Runtime.InteropServices.Guid("934a92fd-b63a-49c7-9284-11aec8c1e03f")>]
type LanguagePreferences = class
interface IVsTextManagerEvents2
interface IDisposable
Public Class LanguagePreferences
Implements IDisposable, IVsTextManagerEvents2
- Herança
-
LanguagePreferences
- Atributos
- Implementações
Comentários
A classe base gerencia as preferências específicas para o serviço de idioma, bem como as preferências gerais que o usuário pode afetar na -> -> categoria Editor de texto opções de ferramentas.
As entradas de registro a seguir são específicas aos serviços de linguagem e já estão refletidas nas propriedades na classe base. Essas entradas de registro são armazenadas na chave do registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\ <X.Y> Serviços \Languages\Languages \<nome do idioma > .
<X.Y> é a versão do Visual Studio (por exemplo, 8,0 ou 8.0 exp).
<Language Name> é o nome do seu idioma.
| Entrada de registro | Tipo | Valor | Descrição |
|---|---|---|---|
| CodeSense | DWORD | <0 or 1> | 1 indica suporte para IntelliSense. |
| MatchBraces | DWORD | <0 or 1> | 1 indica suporte para chaves correspondentes. |
| QuickInfo | DWORD | <0 or 1> | 1 indica suporte para a operação do IntelliSense de informações rápidas . |
| ShowMatchingBraces | DWORD | <0 or 1> | 1 indica que o texto incluído no span para um par correspondente de elementos de linguagem é mostrado na barra de status. |
| MatchBracesAtCaret | DWORD | <0 or 1> | 1 indica que as chaves correspondentes podem ser mostradas ao digitar uma chave correspondente. |
| MaxErrorMessages | DWORD | <number> | O número máximo de mensagens de erro que podem ser colocadas na janela de Opções de lista de erros do analisador. |
| CodeSenseDelay | DWORD | <number> | A quantidade de tempo em milissegundos que o usuário deve manter o cursor sobre um identificador antes de disparar uma operação do IntelliSense. |
| EnableAsyncCompletion | DWORD | <0 or 1> | 1 indica suporte para análise assíncrona ou em segundo plano. |
| EnableCommenting | DWORD | <0 or 1> | 1 indica suporte para comentar e remover comentários de código em uma única operação. |
| EnableFormatSelection | DWORD | <0 or 1> | 1 indica suporte para formatação do texto de origem. |
| Estrutura de tópicos | DWORD | <0 or 1> | 1 indica suporte para estrutura de tópicos automática (isso requer suporte do analisador para regiões ocultas). |
| MaxRegions | DWORD | <number> | O número máximo de regiões ocultas que podem ser manipuladas em um único arquivo. |
Notas aos Herdeiros
Se você tiver propriedades específicas de idioma além das que já têm suporte pela classe base, terá que derivar uma classe de LanguagePreferences e retornar uma instância da classe do GetLanguagePreferences() método. Certifique-se de chamar o Initialize() método antes de retornar sua instância de preferências de idioma. Além disso, você deve substituir InitUserPreferences(RegistryKey, String) OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) Apply() os métodos, e para dar suporte ao acesso às suas propriedades especificadas.
Supõe-se que uma única instância do LanguagePreferences objeto seja mantida para seu serviço de idioma. Dessa forma, todas as alterações feitas pelo usuário nas propriedades são atualizadas dinamicamente em suas preferências e a partir daí, em todo o serviço de idioma.
Notas aos Chamadores
Uma instância dessa classe é retornada do LanguageService método GetLanguagePreferences() . Várias propriedades são referenciadas em toda a versão da estrutura de pacote gerenciado das classes de serviço de linguagem.
Construtores
| LanguagePreferences() |
Inicializa uma nova instância da LanguagePreferences classe (somente inicialização padrão). |
| LanguagePreferences(IServiceProvider, Guid, String) |
Inicializa uma nova instância da LanguagePreferences classe (esse é o método preferencial). |
Propriedades
| AutoListMembers |
Obtém ou define se os membros são listados automaticamente como parte do suporte do IntelliSense. |
| AutoOutlining |
Obtém ou define se o contorno automático tem suporte ou não de estrutura de tópicos (isso requer suporte do analisador para regiões ocultas). |
| CodeSenseDelay |
Obtém ou define o número de milissegundos que o usuário deve manter o cursor sobre um identificador antes de iniciar qualquer operação do IntelliSense. |
| CutCopyBlankLines |
Obtém ou define se devem ser incluídos espaços em linhas em branco ao recortar e copiar. |
| EnableAsyncCompletion |
Obtém ou define se há suporte para a análise em segundo plano. |
| EnableCodeSense |
Obtém ou define se há suporte para o IntelliSense ou não. |
| EnableCommenting |
Obtém ou define se os blocos de código podem ser comentados e não comentados. |
| EnableFormatSelection |
Obtém ou define se o código pode ou não ser formatado. |
| EnableLeftClickForURLs |
Obtém ou define se as URLs no código podem ser navegadas por um simples clique. |
| EnableMatchBraces |
Obtém ou define se há suporte para chaves correspondentes ou não. |
| EnableMatchBracesAtCaret |
Obtém ou define se as chaves correspondentes podem ou não ser mostradas ao digitar uma chave correspondente. |
| EnableQuickInfo |
Obtém ou define se há suporte para a operação de informações rápidas do IntelliSense. |
| EnableShowMatchingBrace |
Obtém ou define se o texto incluído ou não no intervalo do par correspondente é mostrado na barra de status. |
| HideAdvancedMembers |
Obtém ou define se os membros avançados estão ocultos ou não na lista de membros do IntelliSense. |
| HighlightMatchingBraceFlags |
Obtém ou define os sinalizadores para realçar as chaves correspondentes. |
| IndentSize |
Obtém ou define o número de espaços a serem recuados ao Formatar a fonte. |
| IndentStyle |
Obtém ou define o estilo usado para formatar seções de texto. |
| InsertTabs |
Obtém ou define se as guias devem ser inseridas em vez de espaços ao Formatar seções de texto. |
| LanguageName |
Obtém ou define o nome em que o serviço de idioma está registrado. |
| LineNumbers |
Obtém ou define se os números de linha devem ser mostrados ou não. |
| MaxErrorMessages |
Obtém ou define o número máximo de mensagens de erro que podem ser mostradas a qualquer momento. |
| MaxRegionTime |
Obtém ou define o tempo máximo da região. |
| ParameterInformation |
Obtém ou define se a operação Tip do método IntelliSense tem ou não suporte. |
| ShowNavigationBar |
Obtém ou define se as barras suspensas devem ser mostradas ou não. |
| Site |
Obtém ou define o provedor de serviços. |
| TabSize |
Obtém ou define o número de espaços que uma única guia cobre. |
| VirtualSpace |
Obtém ou define se o editor deve ou não presumir espaços no final de todas as linhas. |
| WordWrap |
Obtém ou define se a quebra automática de texto está habilitada ou não. |
| WordWrapGlyphs |
Obtém ou define se um glifo deve ou não ser mostrado para uma linha que está encapsulada por palavra. |
Métodos
| Apply() |
Aplica todas as alterações feitas nas preferências. |
| Dispose() |
Limpa todos os recursos alocados antes de o objeto ser destruído. |
| GetBooleanValue(RegistryKey, String, Boolean) |
Obtém um valor booliano da entrada do Registro especificada. |
| GetIntegerValue(RegistryKey, String, Int32) |
Obtém um valor inteiro da entrada do Registro especificada. |
| GetLanguagePreferences() |
Obtém as configurações de idioma de usuário modificáveis do Visual Studio. |
| GetSite() |
Obtém o provedor de serviços. |
| Init() |
Inicializa LanguagePreferences. |
| InitMachinePreferences(RegistryKey, String) |
Obtém configurações específicas do serviço de idioma do registro. |
| InitUserPreferences(RegistryKey, String) |
Obtém configurações modificáveis pelo usuário. |
| OnRegisterMarkerType(Int32) |
Chamado quando um novo tipo de marcador é registrado com o Visual Studio. |
| OnRegisterView(IVsTextView) |
Chamado quando uma exibição é registrada. |
| OnReplaceAllInFilesBegin() |
Chamado quando a operação substituir tudo nos arquivos foi iniciada. |
| OnReplaceAllInFilesEnd() |
Chamado quando a operação substituir tudo nos arquivos terminou. |
| OnUnregisterView(IVsTextView) |
Chamado quando uma exibição é fechada. |
| OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) |
Chamado quando uma preferência de usuário é alterada. |