LanguagePreferences Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Важно!
Этот API несовместим с CLS.
Обеспечивает поддержку параметров языковой службы.
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
- Наследование
-
LanguagePreferences
- Атрибуты
- Реализации
Комментарии
Базовый класс управляет настройками, характерными для вашей языковой службы, а также общие настройки, которые пользователь может повлиять из категории Сервис -> Параметры -> текстовый редактор .
Следующие записи реестра относятся только к языковым службам и уже отражены в свойствах базового класса. Эти записи реестра хранятся в разделе реестра HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\ <X.Y> \лангуажес\лангуаже Services \<имя языка > .
<X.Y> — Это версия Visual Studio (например, 8,0 или 8.0).
<Language Name> имя вашего языка.
| Запись реестра | Тип | Значение | Описание |
|---|---|---|---|
| кодесенсе | DWORD | <0 or 1> | 1 обозначает поддержку IntelliSense. |
| матчбрацес | DWORD | <0 or 1> | 1 обозначает поддержку парных скобок. |
| Краткие сведения | DWORD | <0 or 1> | 1 обозначает поддержку операции IntelliSense для быстрой информации . |
| шовматчингбрацес | DWORD | <0 or 1> | значение 1 указывает, что текст, включенный в диапазон для соответствующей пары языковых элементов, отображается в строке состояния. |
| матчбрацесаткарет | DWORD | <0 or 1> | 1 указывает, что Парные фигурные скобки могут отображаться при вводе парной скобки. |
| максеррормессажес | DWORD | <number> | Максимальное число сообщений об ошибках, которые могут быть отправлены в окно параметров список ошибок из средства синтаксического анализа. |
| кодесенседелай | DWORD | <number> | Время в миллисекундах, в течение которого пользователь должен удерживать курсор над идентификатором, прежде чем запускать операцию IntelliSense. |
| енаблеасинккомплетион | DWORD | <0 or 1> | 1 обозначает поддержку асинхронного или фонового анализа. |
| енаблекомментинг | DWORD | <0 or 1> | 1 обозначает поддержку комментирования и раскомментирования кода в одной операции. |
| енаблеформатселектион | DWORD | <0 or 1> | 1 обозначает поддержку форматирования исходного текста. |
| аутуутлининг | DWORD | <0 or 1> | 1 обозначает поддержку автоматического структурирования (для этого требуется поддержка синтаксического анализатора для скрытых регионов). |
| максрегионс | DWORD | <number> | Максимальное число скрытых регионов, которые могут быть обработаны в одном файле. |
Примечания для тех, кто наследует этот метод
При наличии свойств, зависящих от языка, помимо тех, которые уже поддерживаются базовым классом, необходимо создать класс, производный от LanguagePreferences метода, и вернуть экземпляр класса GetLanguagePreferences() . Не забудьте вызвать Initialize() метод перед возвратом экземпляра языковых настроек. Кроме того, необходимо переопределить InitUserPreferences(RegistryKey, String) методы, OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) и Apply() для поддержки доступа к указанным свойствам.
Предполагается, что LanguagePreferences для языковой службы поддерживается только один экземпляр объекта. Таким образом, любые изменения, внесенные пользователем в свойства, динамически обновляются в своих предпочтениях и в рамках службы языка.
Примечания для тех, кто вызывает этот метод
Экземпляр этого класса возвращается из LanguageService метода GetLanguagePreferences() . В версии платформы управляемых пакетов классов языковой службы ссылаются на ряд свойств.
Конструкторы
| LanguagePreferences() |
Инициализирует новый экземпляр класса LanguagePreferences (только инициализация по умолчанию). |
| LanguagePreferences(IServiceProvider, Guid, String) |
Инициализирует новый экземпляр класса LanguagePreferences (предпочтительный метод). |
Свойства
| AutoListMembers |
Получает или задает значение, указывающее, предусматривает ли поддержка IntelliSense автоматическое перечисление членов. |
| AutoOutlining |
Получает или задает значение, указывающее, поддерживается ли автоматическое структурирование (это требует поддержки средства синтаксического анализа для скрытых областей). |
| CodeSenseDelay |
Получает или задает время (в миллисекундах), в течение которого пользователь должен удерживать курсор над идентификатором, прежде чем будет инициирована какая-либо операция IntelliSense. |
| CutCopyBlankLines |
Получает или задает значение, указывающее, включать ли пробелы на пустых строках при вырезании и копировании. |
| EnableAsyncCompletion |
Получает или задает значение, указывающее, поддерживается ли синтаксический анализ в фоновом режиме. |
| EnableCodeSense |
Получает или задает значение, указывающее, поддерживается ли IntelliSense. |
| EnableCommenting |
Получает или задает, можно ли комментировать и раскомментировать блоки кода. |
| EnableFormatSelection |
Получает и задает значение, указывающее, можно ли форматировать код. |
| EnableLeftClickForURLs |
Получает или задает значение, указывающее, можно ли переходить к URL-адресу в коде по простому щелчку. |
| EnableMatchBraces |
Получает или задает значение, указывающее, поддерживаются ли парные фигурные скобки. |
| EnableMatchBracesAtCaret |
Получает или задает значение, указывающее, можно ли отображать парные фигурные скобки при вводе парной скобки. |
| EnableQuickInfo |
Возвращает или задает значение, указывающее, поддерживается ли операция быстрой информации IntelliSense. |
| EnableShowMatchingBrace |
Получает или задает значение, указывающее, отображается ли в строке состояния текст, входящий в диапазон пары соответствующих элементов. |
| HideAdvancedMembers |
Получает или задает значение, указывающее, скрыты ли дополнительные члены в списке членов IntelliSense. |
| HighlightMatchingBraceFlags |
Получает или задает флаги для выделения парных фигурных скобок. |
| IndentSize |
Получает или задает количество пробелов для отступа при форматировании источника. |
| IndentStyle |
Получает или задает стиль, используемый для форматирования разделов текста. |
| InsertTabs |
Получает или задает значение, указывающее, вставлять ли символы табуляции вместо пробелов при форматировании разделов текста. |
| LanguageName |
Получает или задает имя, под которым зарегистрирована языковая служба. |
| LineNumbers |
Получает или задает значение, указывающее, отображать ли номера строк. |
| MaxErrorMessages |
Получает или задает максимальное число сообщений об ошибке, которые можно показать одновременно. |
| MaxRegionTime |
Получает или задает максимальное время области. |
| ParameterInformation |
Получает или задает значение, указывающее, поддерживается ли операция подсказки метода IntelliSense. |
| ShowNavigationBar |
Получает или задает значение, указывающее, отображать ли раскрывающиеся панели. |
| Site |
Получает или задает поставщик службы. |
| TabSize |
Получает или задает количество пробелов, охватываемых одним символом табуляции. |
| VirtualSpace |
Получает или задает значение, указывающее, должен ли редактор предполагать пробелы на конце всех строк. |
| WordWrap |
Получает или задает значение, указывающее, разрешен ли перенос по словам. |
| WordWrapGlyphs |
Получает или задает значение, указывающее, должен ли глиф отображаться для строки с переносом по словам. |
Методы
| Apply() |
Применяет все изменения, сделанные в глобальных настройках. |
| Dispose() |
Очищает какие-либо выделенные ресурсы перед уничтожением объекта. |
| GetBooleanValue(RegistryKey, String, Boolean) |
Получает логическое значение из указанной записи реестра. |
| GetIntegerValue(RegistryKey, String, Int32) |
Получает целое значение из указанной записи реестра. |
| GetLanguagePreferences() |
Получает изменяемые параметры языка пользователя из Visual Studio. |
| GetSite() |
Получает поставщик служб. |
| Init() |
Инициализирует LanguagePreferences. |
| InitMachinePreferences(RegistryKey, String) |
Получает из реестра параметры, относящиеся к языковой службе. |
| InitUserPreferences(RegistryKey, String) |
Возвращает изменяемые пользователем параметры. |
| OnRegisterMarkerType(Int32) |
Вызывается при регистрации нового типа маркера в Visual Studio. |
| OnRegisterView(IVsTextView) |
Вызывается при регистрации представления. |
| OnReplaceAllInFilesBegin() |
Вызывается при начале операции "Заменить все" в файлах. |
| OnReplaceAllInFilesEnd() |
Вызывается при окончании операции "Заменить все" в файлах. |
| OnUnregisterView(IVsTextView) |
Вызывается при закрытии представления. |
| OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) |
Вызывается после изменения пользовательских параметров. |