Freigeben über


Gespeicherte Schriftart-und zugreifen Farben-Einstellungen

Die Visual Studio integrierte Entwicklungsumgebung (IDE) speichert die geänderten Einstellungen für Schriftarten und Farben in der Registrierung. Sie können die IVsFontAndColorStorage-Schnittstelle können Sie diese Einstellungen zuzugreifen.

So Zustands-Persistenz für Schriftarten und Farben initiieren

Schriftart und Farbinformationen werden nach Kategorie im folgenden Registrierungsspeicherort gespeichert: [HKCU \ SOFTWARE \ Microsoft \ Visual Studio \ <Visual Studio version> \ FontAndColors \ <CategoryGUID> ], wobei <CategoryGUID> die Kategorie GUID ist.

Daher Dauerhaftigkeit initiieren, muss ein VSPackage:

  • Rufen Sie eine IVsFontAndColorStorage-Schnittstelle, indem sie QueryService für den globalen Dienstanbieter aufruft.

    QueryService muss aufgerufen werden, indem ein Dienst ID von SID_SVsFontAndColorStorage-Argument und ein Schnittstellen-ID-Argument von IID_IVsFontAndColorStorageverwendet.

  • Verwenden Sie die OpenCategory-Methode, um eine indem Sie beibehalten werden soll, Kategorie zu öffnen, und die GUID der Kategorie ein Modus flag als Argumente verwenden.

    Der Modus, angegeben durch das fFlags-Argument, wird von den Werten in der __FCSTORAGEFLAGS-Enumeration erstellt. Dieser Modus steuert:

    • Die Einstellungen, die von der IVsFontAndColorStorage-Schnittstelle zugegriffen werden kann.

    • Entweder alle Einstellungen oder nur diejenigen, die Benutzer ändern und die von der IVsFontAndColorStorage-Schnittstelle abrufbar sind.

    • Die Art des Weitergebens von Änderungen an den Benutzereinstellungen.

    • Das Format von Farbwerten, die verwendet werden.

So Zustands-Persistenz für Schriftarten und Farben verwenden

Das Beibehalten von Schriftarten und Farben umfasst ein:

  • Die IDE-Einstellungen Synchronisieren mit den Einstellungen in der Registrierung gespeichert.

  • Informationen zur Änderung der Registrierung weitergeben.

  • Das Abrufen und Festlegen der Einstellungen in der Registrierung gespeichert.

Die IDE-Einstellungen Einstellung Speicher mit den zu synchronisierenden ist größtenteils transparent. Das zugrunde liegende IDE schreibt automatisch aktualisierte Einstellungen für Elemente anzeigen zu den Kategorien von Registrierungseinträgen.

Wenn mehrere soll VSPackages-Freigabe eine bestimmte Kategorie, VSPackages erfordern, dass Ereignisse generiert werden, wenn IVsFontAndColorStorage-Methoden der Schnittstelle verwendet werden, um gespeicherte Registrierungseinstellungen zu ändern.

Generierung Ereignis ist standardmäßig nicht aktiviert. Zur Generierung Ereignis zu aktivieren, muss eine Kategorie mit FCSF_PROPAGATECHANGESgeöffnet werden. Dadurch wird die IDE, die entsprechende IVsFontAndColorEvents-Methode aufzurufen, die ein VSPackage implementieren.

Hinweis

Änderungen von der Schriftart und Farben-Eigenschaftenseite IVsFontAndColorStoragevon unabhängigen Ereignis generieren.Sie können die IVsFontAndColorCacheManager-Schnittstelle können Sie feststellen, ob eine Aktualisierung zwischengespeicherter Schriftart- und Farbeinstellungen erforderlich ist, bevor Sie die Methoden der IVsFontAndColorStorage-Klasse aufrufen.

Speichern und Abrufen von Informationen

Abrufen oder Informationen zu konfigurieren, die ein Benutzer für ein benanntes Anzeigen element in einer geöffneten Kategorie, in einem VSPackages-Aufruf das GetItem und SetItem-Auflistungsmethoden ändern kann.

Informationen über Attribute Schriftart für eine bestimmte Kategorie werden abgerufen, indem das GetFont und die SetFont-Methode verwendet.

Hinweis

Das fFlagsOpenCategory-Argument, das an die Methode übergeben wurde, als diese Kategorie geöffnet wurde, definiert das Verhalten des GetItem und der GetFont-Methode.Standardmäßig verfügen nur dieser Methoden geben Informationen aboutdisplayitemsthatgeändert.Wenn jedoch eine Kategorie mit dem FCSF_LOADDEFAULTS-Flags geöffnet ist, können aktualisiert und unveränderte Anzeigen von Elementen GetItem und GetFontzugegriffen werden.

Standardmäßig werden nur geänderte Elemente anzeigen Informationen werden in der Registrierung gespeichert. Die IVsFontAndColorStorage-Schnittstelle kann nicht verwendet werden, um alle Einstellungen für Schriftarten und Farben abzurufen.

Hinweis

Das GetItem und die GetFont-Methoden geben REGDB_E_KEYMISSING zurück (0x80040152L), wenn Sie sie verwenden, um Informationen über unverändertes Elemente anzeigenabzurufen.

Die Einstellungen aller Elemente anzeigen in bestimmten Kategorie können abgerufen werden, indem die Methoden der T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorDefaults-Schnittstelle verwendet.

Siehe auch

Referenz

IVsFontAndColorStorage

__FCSTORAGEFLAGS

Konzepte

Benutzerdefinierte Kategorien und Implementieren Anzeigen-Elemente