Controllo di accesso (controllo del codice sorgente VSPackage)
La parte dell'integrazione approfondita disponibile nel controllo del codice sorgente Vspackage è la possibilità di visualizzare i propri icone per indicare lo stato degli elementi nel controllo del codice sorgente.
Livelli di controllo del glifo
Un'icona di stato viene visualizzata un'icona che indica lo stato corrente di un elemento quando viene visualizzato, ad esempio in Esplora soluzioni o in Visualizzazione classi. Un controllo del codice sorgente VSPackage possibile utilizzare due livelli di controllo del glifo. È possibile limitare la scelta dei glifi a un insieme predefinito di glifi forniti dall'IDE di Visual Studio , o possibile definire un set personalizzato dei glifi da visualizzare.
Set predefinito di glifi
Per determinare le icone di stato associati a un elemento in Esplora soluzioni, un progetto il glifo di stato dal controllo del codice sorgente utilizzando dell'entity_M:Microsoft.VisualStudio.Shell.Interop.IVsSccManager2.GetSccGlyph(System.Int32, System.String[], Microsoft.VisualStudio.Shell.Interop.VsStateIcon[], System.UInt32[]). Un controllo del codice sorgente VSPackage possibile decidere di mantenere la scelta dei glifi limitati ai glifi predefiniti forniti dall'IDE. In questo caso, il package VS il passaggio di una matrice di valori che rappresentano le enumerazioni di glifo definite in vsshell.idl. Per ulteriori informazioni, vedere VsStateIcon . Si tratta di un insieme predefinito di glifi impostati dall'IDE, ad esempio un lucchetto per il glifo “archiviato e un segno di spunta come “ha avuto„ il glifo.
Personalizzato insieme di glifi
Un controllo del codice sorgente VSPackage possibile utilizzare i propri glifi per “un aspetto univoco e proprio„ quando viene installato. Quando un nuovo controllo del codice sorgente VSPackage è attivo, deve poter iniziare utilizzando i propri glifi anche se un controllo del codice sorgente precedente VSPackage viene caricato ma inattivo. In questa modalità, il controllo del codice sorgente VSPackage ancora possibile utilizzare le icone esistenti per gestire un essere coerente con Visual Studio se scegliere.
Il servizio di SVsSccManager supporta un'interfaccia, IVsSccGlyphs, che il package VS possibile implementare e che saranno richiesto dall'IDE. Quando l'ide esegue una richiesta, Visual Studio a sua volta tenterà di ottenere questa interfaccia dal controllo del codice sorgente attualmente registrato VSPackage. Se l'interfaccia esiste nel package VS registrato, la richiesta dell'IDE per i glifi personalizzati ha esito positivo; in caso contrario, l'ide di Visual Studio utilizza il relativo set predefinito di glifi.
Il metodo di GetCustomGlyphList viene utilizzato da Visual Studio per ottenere un elenco di immagini che mostrano i diversi stati del controllo del codice sorgente. Il controllo del codice sorgente VSPackage restituisce all'handle all'elenco di immagini per i glifi personalizzati. L'ide esegue una copia dell'elenco immagini in questa fase e utilizzarla in un secondo momento per selezionare i glifi da visualizzare. Se la nuova interfaccia non è supportata o il metodo di IVsSccGlyphs::GetCustomGlyphList restituisce E_NOTIMPL, quindi l'ide ottiene i glifi dall'elenco predefinito dei glifi forniti da Visual Studio.