LanguagePreferences Klasse

Definition

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.

Gilt für