Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein Teil der tiefen Integration, die für Quellsteuerungs-VSPackages verfügbar ist, besteht in der Möglichkeit, eigene Symbole anzuzeigen, um den Status von Elementen unter Quellsteuerung anzuzeigen.
Kontroll-Ebenen für Glyphen
Eine Statusglyphe ist ein Symbol, das den aktuellen Status eines Elements angibt, wenn es angezeigt wird, z. B. im Projektmappen-Explorer oder in der Klassenansicht. Ein Quellcodeverwaltungs-VSPackage kann zwei Ebenen der Glyphensteuerung ausüben. Sie kann die Auswahl von Glyphen auf einen vordefinierten Satz von Glyphen beschränken, die von der Visual Studio-IDE bereitgestellt werden, oder sie kann einen benutzerdefinierten Satz von Glyphen definieren, der angezeigt werden soll.
Standardsatz von Glyphen
Um die Zustandsglyphen zu bestimmen, die einem Element im Projektmappen-Explorer zugeordnet sind, fordert ein Projekt die Zustandsglyphe aus der Quellcodeverwaltung mithilfe der GetSccGlyph. Ein Quellcodeverwaltungs-VSPackage kann die Auswahl von Glyphen auf vordefinierte Glyphen beschränken, die von der IDE bereitgestellt werden. In diesem Fall übergibt vsPackage ein Array von Werten zurück, das die in vsshell.idl definierten Glyphenaufzählungen darstellt. Weitere Informationen finden Sie unter VsStateIcon. Dies ist ein vordefinierter Satz von Glyphen, die von der IDE festgelegt werden, z. B. ein Vorhängeschloss für die eingecheckte Glyphe und ein Häkchen für die ausgecheckte Glyphe.
Benutzerdefinierter Satz von Glyphen
Ein Quellcodeverwaltungs-VSPackage kann seine eigenen Glyphen für ein einzigartiges Aussehen und Verhalten verwenden, wenn es installiert ist. Wenn eine neue Quellcodeverwaltung VSPackage aktiv ist, sollte sie mit der Verwendung eigener Glyphen beginnen können, auch wenn ein vorheriges Quellcodeverwaltungs-VSPackage noch geladen, aber inaktiv ist. In diesem Modus kann das Quellcodeverwaltungs-VSPackage weiterhin die vorhandenen Symbole verwenden, um ein einheitliches Erscheinungsbild mit Visual Studio zu erhalten, wenn dies der Fall ist.
Der SVsSccManager Dienst unterstützt eine Schnittstelle, IVsSccGlyphsdie vom VSPackage optional implementiert werden kann und die von der IDE angefordert wird. Wenn die IDE eine Anforderung sendet, versucht Visual Studio wiederum, diese Schnittstelle aus der aktuell registrierten Quellcodeverwaltung VSPackage abzurufen. Wenn die Schnittstelle im registrierten VSPackage vorhanden ist, ist die Anforderung der IDE für benutzerdefinierte Glyphen erfolgreich; andernfalls verwendet die Visual Studio-IDE den Standardsatz von Glyphen.
Die GetCustomGlyphList Methode wird von Visual Studio verwendet, um eine Liste von Bildern abzurufen, die verschiedene Quellcodeverwaltungszustände anzeigen. Das Quellcodeverwaltungs-VSPackage stellt der IDE ein Handle zur Bildliste für seine benutzerdefinierten Glyphen zur Verfügung. Die IDE erstellt an diesem Punkt eine Kopie der Bildliste und verwendet sie später, um die anzuzeigenden Glyphen auszuwählen. Wenn die neue Schnittstelle nicht unterstützt wird oder die IVsSccGlyphs::GetCustomGlyphList Methode E_NOTIMPL ergibt, bezieht die IDE ihre Glyphen aus der Standardliste, die von Visual Studio bereitgestellt wird.