IVsFontAndColorStorage.OpenCategory(Guid, UInt32) Methode

Definition

Öffnet den Registrierungsschlüssel, der Schriftart-und Farbinformationen für eine in der Dropdown Liste Einstellungen anzeigen für: gefundene Kategorie enthält.

public:
 int OpenCategory(Guid % rguidCategory, System::UInt32 fFlags);
public int OpenCategory (ref Guid rguidCategory, uint fFlags);
abstract member OpenCategory : Guid * uint32 -> int
Public Function OpenCategory (ByRef rguidCategory As Guid, fFlags As UInteger) As Integer

Parameter

rguidCategory
Guid

in Gibt die GUID der Kategorie von Elemente anzeigen an, auf deren Informationen zugegriffen werden soll.

fFlags
UInt32

[in] Gibt an, wie auf die Informationen einer Kategorie zugegriffen werden soll. Die Werte werden der __FCSTORAGEFLAGS-Enumeration entnommen.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus vsshell. idl:

HRESULT IVsFontAndColorStorage::OpenCategory(  
   [in] REFGUID rguidCategory,  
   [in] FCSTORAGEFLAGS fFlags  
);  

Der aktuelle Änderungs Zustand einer Kategorie und deren Anzeigeelemente wird unter [HKLM\SOFTWARE\Microsoft \Visual Studio \<Visual Studio-Version > \fontandcolors \<Kategorie > ] gespeichert.

Where <Category> wird durch den- rguidCategory Parameter angegeben.

Ein Registrierungs Eintrag, der durch einen-Befehl geöffnet wird, wird IVsFontAndColorStorage.OpenCategory automatisch geschlossen, wenn:

  • CloseCategory wird explizit aufgerufen.

  • Die aktuelle Instanz der IVsFontAndColorStorage Schnittstelle wird zerstört.

  • OpenCategory wird für eine andere Kategorie aufgerufen.

Das explizite schließen von Einträgen durch Aufrufen von CloseCategory ist eine bewährte Vorgehensweise, da dadurch sichergestellt wird, dass kein Code aus einer Kategorie liest oder in diese schreibt.

Gilt für