LanguagePreferences Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wichtig
Diese API ist nicht CLS-kompatibel.
Bietet Unterstützung für sprachdienstspezifische Einstellungen.
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
- Vererbung
-
LanguagePreferences
- Attribute
- Implementiert
Hinweise
Die Basisklasse verwaltet die für Ihren Sprachdienst spezifischen Einstellungen sowie die allgemeinen Einstellungen, die der Benutzer über die Kategorie Extras -> Optionen -> Text-Editor beeinflussen kann.
Die folgenden Registrierungseinträge sind spezifisch für Sprachdienste und werden bereits in den Eigenschaften der-Basisklasse berücksichtigt. Diese Registrierungseinträge werden im Registrierungsschlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\ <X.Y> \languages\sprach Dienste \<sprach Name gespeichert > .
<X.Y> ist die Version von Visual Studio (z. b. 8,0 oder 8.0 Exp).
<Language Name> der Name der Sprache.
| Registrierungseintrag | Typ | Wert | Beschreibung |
|---|---|---|---|
| CodeSense | DWORD | <0 or 1> | 1 gibt an, dass IntelliSense unterstützt wird. |
| Matchgeschweifte Klammern | DWORD | <0 or 1> | 1 gibt die Unterstützung für passende geschweifte Klammern an. |
| QuickInfo | DWORD | <0 or 1> | 1 gibt die Unterstützung für den IntelliSense- schnell Info Vorgang an. |
| Showmatchinggeschweifte Klammern | DWORD | <0 or 1> | der Wert 1 gibt an, dass der Text, der in der Spanne für ein entsprechendes paar von Sprachelementen enthalten ist, in der Statusleiste angezeigt wird. |
| Matchbracesatcaret | DWORD | <0 or 1> | 1 gibt an, dass passende geschweifte Klammern angezeigt werden können, während eine passende geschweifte Klammer eingegeben wird. |
| Maxerrormessages | DWORD | <number> | Die maximale Anzahl von Fehlermeldungen, die vom Parser in das Fenster Fehlerliste Optionen eingefügt werden können. |
| Codesenydelay | DWORD | <number> | Die Zeitspanne in Millisekunden, die der Benutzer den Cursor über einen Bezeichner halten muss, bevor ein IntelliSense-Vorgang ausgelöst wird. |
| EnableAsyncCompletion | DWORD | <0 or 1> | 1 gibt die Unterstützung für asynchrone oder im Hintergrund ausgeführten Informationen an. |
| Enablekommentieren | DWORD | <0 or 1> | 1 gibt die Unterstützung für das kommentieren und auskommentieren von Code in einem einzelnen Vorgang an. |
| Enableformatselection | DWORD | <0 or 1> | 1 gibt die Unterstützung für die Formatierung des Quell Texts an. |
| Automatische Gliederung | DWORD | <0 or 1> | 1 gibt die Unterstützung für die automatische Gliederung an. |
| Maxregions | DWORD | <number> | Die maximale Anzahl ausgeblendeter Bereiche, die in einer einzelnen Datei verarbeitet werden können. |
Hinweise für Vererber
Wenn Sie zusätzlich zu den bereits von der Basisklasse unterstützten sprachspezifischen Eigenschaften verfügen, müssen Sie eine Klasse von ableiten LanguagePreferences und von der-Methode eine Instanz der-Klasse zurückgeben GetLanguagePreferences() . Stellen Sie sicher, dass Sie die- Initialize() Methode vor dem Zurückgeben der sprach Einstellungs Instanz aufruft. Außerdem müssen Sie InitUserPreferences(RegistryKey, String) OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) die Methoden, und überschreiben, Apply() um den Zugriff auf die angegebenen Eigenschaften zu unterstützen.
Es wird davon ausgegangen, dass eine einzelne Instanz des- LanguagePreferences Objekts für Ihren Sprachdienst beibehalten wird. Auf diese Weise werden alle Änderungen, die der Benutzer an den Eigenschaften vornimmt, in Ihren Einstellungen und von dort aus im gesamten Sprachdienst dynamisch aktualisiert.
Hinweise für Aufrufer
Eine Instanz dieser Klasse wird von der-Methode zurückgegeben LanguageService GetLanguagePreferences() . Auf eine Reihe von Eigenschaften wird in der verwalteten Paket Framework-Version der Sprachdienst Klassen verwiesen.
Konstruktoren
| LanguagePreferences() |
Initialisiert eine neue Instanz der LanguagePreferences-Klasse (nur Standardinitialisierung). |
| LanguagePreferences(IServiceProvider, Guid, String) |
Initialisiert eine neue Instanz der LanguagePreferences-Klasse (dies ist die bevorzugte Methode). |
Eigenschaften
| AutoListMembers |
Ruft ab oder bestimmt, ob Member automatisch als Teil der IntelliSense-Unterstützung aufgeführt werden. |
| AutoOutlining |
Ruft ab oder legt fest, ob automatisches Gliedern unterstützt wird (erfordert Parserunterstützung für ausgeblendete Bereiche). |
| CodeSenseDelay |
Ruft die Anzahl von Millisekunden ab oder legt diese fest, während der ein Benutzer den Cursor über einem Bezeichner halten muss, bevor irgend ein IntelliSense-Vorgang gestartet wird. |
| CutCopyBlankLines |
Ruft ab oder legt fest, ob beim Ausschneiden und Kopieren Leerzeichen auf leeren Zeilen eingefügt werden. |
| EnableAsyncCompletion |
Ruft ab oder legt fest, ob Hintergrundanalysierung unterstützt wird. |
| EnableCodeSense |
Ruft ab oder legt fest, ob IntelliSense unterstützt wird. |
| EnableCommenting |
Ruft ab oder legt fest, ob Codeblöcke kommentiert und auskommentiert werden können. |
| EnableFormatSelection |
Ruft ab oder legt fest, ob Code formatiert werden kann. |
| EnableLeftClickForURLs |
Ruft ab oder legt fest, ob zu URLs im Code mit einem einfachen Klick navigiert werden kann. |
| EnableMatchBraces |
Ruft ab oder legt fest, ob zusammengehörende geschweifte Klammern unterstützt werden. |
| EnableMatchBracesAtCaret |
Ruft ab oder legt fest, ob zusammengehörende geschweifte Klammern beim Eingeben einer entsprechenden Klammer angezeigt werden. |
| EnableQuickInfo |
Ruft ab oder legt fest, ob der IntelliSense-Quick Info-Vorgang unterstützt wird. |
| EnableShowMatchingBrace |
Ruft ab oder legt fest, ob der Text, der in der Spanne entsprechender Paare enthalten ist, in der Statusleiste angezeigt wird. |
| HideAdvancedMembers |
Ruft ab oder legt fest, ob erweiterte Member in der IntelliSense-Memberliste ausgeblendet werden. |
| HighlightMatchingBraceFlags |
Ruft die Flags zur Hervorhebung von übereinstimmenden geschweiften Klammern ab oder legt diese fest. |
| IndentSize |
Ruft die Anzahl der Leerzeichen für den Einzug beim Formatieren von Quellcode ab oder legt diese fest. |
| IndentStyle |
Ruft den für die Formatierung von Textabschnitten verwendeten Stil ab oder legt diesen fest. |
| InsertTabs |
Ruft ab oder legt fest, ob Tabstopps statt Leerzeichen eingefügt werden, wenn Textabschnitte formatiert werden. |
| LanguageName |
Ruft den Namen ab oder legt diesen fest, unter welchem der Sprachdienst registriert ist. |
| LineNumbers |
Ruft ab oder legt fest, ob Zeilennummern angezeigt werden. |
| MaxErrorMessages |
Ruft die maximale Anzahl der Fehlermeldungen ab, die gleichzeitig angezeigt werden können, oder legt diese fest. |
| MaxRegionTime |
Ruft die maximale Regionenzeit ab oder legt diese fest. |
| ParameterInformation |
Ruft ab oder legt fest, ob der IntelliSense-Methodentippvorgang unterstützt wird. |
| ShowNavigationBar |
Ruft ab oder legt fest, ob Dropdownleisten angezeigt werden. |
| Site |
Ruft den Dienstanbieter ab oder legt diesen fest. |
| TabSize |
Ruft die Anzahl von Leerzeichen ab, bzw. legt diese fest, welche ein einmaliges Drücken der Tabulatortaste abdeckt. |
| VirtualSpace |
Ruft ab oder legt fest, ob der Editor davon ausgeht, dass Leerzeichen am Ende aller Zeilen stehen. |
| WordWrap |
Ruft ab oder legt fest, ob der Zeilenumbruch aktiviert ist. |
| WordWrapGlyphs |
Ruft ab oder legt fest, ob ein Symbol für eine Zeile mit Wortumbruch angezeigt werden soll. |
Methoden
| Apply() |
Wendet alle Änderungen auf die Einstellungen an. |
| Dispose() |
Bereinigt jede zugeordneten Ressource, kurz bevor das Objekt zerstört wird. |
| GetBooleanValue(RegistryKey, String, Boolean) |
Ruft einen booleschen Wert vom angegebenen Registrierungseintrag ab. |
| GetIntegerValue(RegistryKey, String, Int32) |
Ruft einen ganzzahligen Wert des angegebenen Registrierungseintrags ab. |
| GetLanguagePreferences() |
Ruft die änderbaren Benutzerspracheinstellungen aus Visual Studio ab. |
| GetSite() |
Ruft den Dienstanbieter ab. |
| Init() |
Initialisiert LanguagePreferences. |
| InitMachinePreferences(RegistryKey, String) |
Ruft sprachdienstspezifische Einstellungen aus der Registrierung ab. |
| InitUserPreferences(RegistryKey, String) |
Ruft vom Benutzer änderbare Einstellungen ab. |
| OnRegisterMarkerType(Int32) |
Wird aufgerufen, wenn ein neuer Markertyp in Visual Studio registriert wird. |
| OnRegisterView(IVsTextView) |
Wird aufgerufen, wenn eine Ansicht registriert wird. |
| OnReplaceAllInFilesBegin() |
Wird aufgerufen, wenn der Vorgang "Alle in Dateien Ersetzen" gestartet wurde. |
| OnReplaceAllInFilesEnd() |
Wird aufgerufen, wenn der Vorgang "Alle in Dateien Ersetzen" beendet wurde. |
| OnUnregisterView(IVsTextView) |
Wird aufgerufen, wenn eine Ansicht geschlossen wird. |
| OnUserPreferencesChanged2(VIEWPREFERENCES2[], FRAMEPREFERENCES2[], LANGPREFERENCES2[], FONTCOLORPREFERENCES2[]) |
Wird aufgerufen, wenn eine Benutzereinstellung geändert wurde. |