Für benutzerdefinierte färbbare Elemente

Artikel
05/16/2015

Sie können die Liste der Typen zum Darfarbig bereitstellen, z. B. Schlüsselwörter und Kommentare überschreiben, indem Sie benutzerdefinierte färbbare Elemente als Teil des Sprachdiensts implementieren.

Elemente färbbaren von Benutzereinstellungen

Sie können das Schriftarten und Farben Dialogfeld anzeigen, indem Sie im Menü ExtrasOptionen auswählen und dann Schriftarten und Farben unter Umgebungauswählen. Wenn Sie auswählen, wird eine Anzeige, wie Text-Editor oder Befehlsfenster, das Elemente anzeigen Listenfeld alle färbbaren für diese Elemente an. Sie können die Schriftart, Größe, Hintergrundfarbe und die Vordergrundfarbe für jedes färbbare Element anzeigen und ändern. Die Optionen werden in einem Cache in der Registrierung gespeichert und vom Zugriff färbbaren Elementnamen.

Elemente färbbaren der Vorlage

Da die IDE Benutzer überschreibungen von färbbaren Elemente im Dialogfeld Schriftarten und Farben behandelt, müssen Sie lediglich jedes benutzerdefinierte färbbare Element mit einem Namen angeben. Dieser Name ist, was in der Elemente anzeigen Liste angezeigt wird. Die färbbaren Elemente werden in alphabetischer Reihenfolge. Um die benutzerdefinierten färbbaren Elemente des Sprachdiensts zu gruppieren, können Sie einen Namen mit dem Sprachnamen, z. B. NewLanguage - Kommentar und NewLanguage - Schlüsselwortstarten.

Warnung

Sie sollten den Sprachennamen im färbbaren Elementnamen einschließen, um Konflikte mit vorhandenen färbbaren Elementnamen zu vermeiden.Wenn Sie den Namen eines der Elemente färbbaren während der Entwicklung ändern, müssen Sie den Cache zurücksetzen, das das erste Mal auf die Elemente zugegriffen wurde färbbaren erstellt wurde.Sie können den experimentellen Cache mit dem vsregex Tool zurücksetzen.Verwenden Sie die Befehlszeile vsregex GetOrig 10.0 Expund die entsprechende Versions- und Name der Registrierung Erweiterung für die Version von Visual Studioersetzen.Das vsregex Tool wird mit Visual Studio SDKinstalliert.Weitere Informationen zu vsregex finden Sie im Thema „in“ VsRegEx-Befehlszeile die Experimentelle Instanz von Visual Studio.

Der erste Punkt in der Liste der färbbaren Elementen wird nicht verwiesen. Der erste Punkt entspricht einem färbbaren Elementindex zwischen 0 und Visual Studio stellt immer die Farben Standardtext und - Attribute für dieses Element. Die einfachste Art des Beschäftigens dieses Element nicht verwiesen wird, ein färbbares Element des Platzhalters in der Liste als Erstes Element zu erzeugen.

Für benutzerdefinierte färbbare Elemente implementieren

Definieren Sie, was in der Sprache (z Schlüsselwort, Operator und Bezeichner darfarbig.
Erstellen Sie eine Enumeration der färbbaren Elemente.
Ordnen Sie die Tokentypen an, die von einem Parser oder einem Scanner mit den Enumerationswerten zurückgegeben werden.

Beispielsweise können die Werte, die den Tokentypen darstellen, die gleichen Werte in der benutzerdefinierten färbbaren - Enumeration sein.
In der Implementierung der ColorizeLine-Methode im IVsColorizer-Objekt, füllen Sie die Liste Attribut mit den Werten aus der benutzerdefinierten färbbaren Element Enumeration, die den Tokentypen aus, die vom Parser und vom Scanner zurückgegeben werden.
In derselben Klasse, die die IVsLanguageInfo-Schnittstelle implementiert, implementieren Sie die IVsProvideColorableItems-Schnittstelle und ihre zwei Möglichkeiten, GetItemCount und GetColorableItem.
Implementieren Sie die IVsColorableItem-Schnittstelle.
Wenn Sie 24-Bit oder hohe Farbwerte unterstützen möchten, implementieren Sie zusätzlich die IVsHiColorItem-Schnittstelle.
Im Sprachdienst Objekt erstellen Sie eine Liste, die die IVsColorableItem-Objekte enthält, eines für jedes färbbare Element der Parser Scanner oder identifizieren kann.

Sie können jedes Element in der Liste zugreifen, indem Sie den entsprechenden Wert aus der benutzerdefinierten färbbaren Element Enumeration verwenden. Verwenden Sie die Enumerationswerte als Index in der Liste. Der erste Listenelement wird nicht zugegriffen werden, da er dem Standardtext für Visual Studio entspricht immer selbst behandelt. Sie können dieses kompensieren, indem Sie ein färbbares Element des Platzhalters Anfang der Liste einfügen.
In der Implementierung der GetItemCount-Methode, geben Sie die Anzahl der Elemente in der benutzerdefinierten färbbaren Elementliste zurück.
In der Implementierung der GetColorableItem-Methode, geben Sie das angeforderte färbbare Element aus der Liste zurück.