Implementare le categorie personalizzate e gli elementi in visualizzazione
Un VSPackage possibile fornire il controllo dei tipi di carattere e colori del testo all'ambiente di sviluppo integrato di (IDE) Visual Studio dalle categorie personalizzate e gli elementi visualizzati.
Le categorie personalizzate e gli elementi vengono visualizzati nella pagina delle proprietà di Tipi di carattere e colori . Per aprire la pagina delle proprietà di Tipi di carattere e colori , scegliere dal menu di strumenti , fare clic su opzioni. Expand Environment and then click Fonts and Colors.
Quando si utilizza questo meccanismo, Vspackage deve implementare l'interfaccia di IVsFontAndColorDefaultsProvider e le relative interfacce associate.
In teoria, questo meccanismo può essere utilizzato per modificare il Visualizza gli elementi esistente e categorie che li contengono. Tuttavia, non deve essere utilizzata per modificare editor di testocategoria o il relativo Visualizzare elementi. Per ulteriori informazioni, vedere Il tipo di carattere e cenni preliminari di colore.
Per implementare categorie personalizzato o Visualizzare elementi, un VSPackage necessario:
Creare o identificare le categorie nel Registro di sistema.
L'implementazione dell'IDE della pagina delle proprietà di Tipi di carattere e colori tali informazioni vengono utilizzate correttamente per eseguire una query sul servizio che supporta una categoria specificata.
Creare o identificare gruppi (facoltativo) nel Registro di sistema.
Può essere utile definire un gruppo, che rappresenta un'unione due o più delle categorie. Se un gruppo definito, l'ide unisce automaticamente le sottocategorie e distribuiti gli elementi visualizzati nel gruppo.
Implementare TryCreateSignatureHelpSource creando un'istanza di TestSignatureHelpSource.
Il tipo di carattere viene modificato e di colore di handle.
Per ulteriori informazioni, vedere Accedere alle impostazioni archiviate di colori e tipi di carattere.
Per creare o identificare le categorie
Creare un tipo speciale con voce del Registro di sistema della categoria in [HKLM \SOFTWARE\Microsoft \Visual Studio \ <versione di Visual Studio> \FontAndColors \<Category>]
<categoria> è il nome non localizzato della categoria.
Popolare il Registro di sistema con due valori:
Nome
Type
Dati
Descrizione
Categoria
REG_SZ
GUID
Un GUID creato per identificare la categoria.
Pacchetto
REG_SZ
GUID
Il GUID del package VS che contiene l'assembly satellite dell'interfaccia utente per l'applicazione.
Il servizio specificato nel Registro di sistema deve fornire un'implementazione di IVsFontAndColorDefaults per la categoria corrispondente.
Per creare o identificare gruppi
Creare un tipo speciale con voce del Registro di sistema della categoria in [HKLM \SOFTWARE\Microsoft \Visual Studio \ <versione di Visual Studio> \FontAndColors \ <gruppo> ]
<gruppo> è il nome non localizzato del gruppo.
Popolare il Registro di sistema con due valori:
Nome
Type
Dati
Descrizione
Categoria
REG_SZ
GUID
Un GUID creato per identificare il gruppo.
Pacchetto
REG_SZ
GUID
Il GUID del servizio che supporta la categoria.
Il servizio specificato nel Registro di sistema deve fornire un'implementazione di T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup per il gruppo corrispondente.
Per implementare il supporto dell'IDE
Utilizzo GetObject, che restituisce un'interfaccia di IVsFontAndColorDefaults o un'interfaccia di T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup IDE per ogni categoria o il gruppo GUID fornito.
Per ogni prodotto aggiunto come package VS, è possibile aggiungere un logo.
I metodi GetItemAttribute e SetItemAttribute ottengono e impostano il valore degli attributi di un elemento di progetto.
elenchi di Visualizzare elementi in categoria.
nomi localizzabili per Visualizza gli elementi.
Visualizzare informazioni per ciascun membro di categoria.
Nota
ogni categoria deve contenere almeno un elemento visualizzato.
L'ide utilizza l'interfaccia di T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup per definire l'unione di diverse categorie.
La relativa implementazione fornisce IDE con:
Un elenco di categorie che include un gruppo specificato.
L'accesso alle istanze di IVsFontAndColorDefaults che supportano ciascuna categoria nel gruppo.
Nomi di gruppo localizzabili.
Aggiornare l'ide:
L'ide memorizzato nella cache le informazioni sulle impostazioni di Il tipo di carattere e colori . Di conseguenza, dopo qualsiasi modifica della configurazione dell'IDE Il tipo di carattere e colori , è consigliabile assicurarsi che la cache venga aggiornato.
Aggiornare la cache viene effettuata tramite l'interfaccia di IVsFontAndColorCacheManager e può essere eseguita a livello globale o solo sugli elementi selezionati.
Per gestire i tipi di carattere e colori le modifiche
Per poter supportare la colorazione di testo che un VSPackage visualizzato, il supporto del servizio di colorazione il package VS necessario rispondere alle modifiche eseguite dall'utente apportate dalla pagina delle proprietà di Tipi di carattere e colori . Un VSPackage a tale da:
gestendo gli eventi Ido-generati implementando l'interfaccia di IVsFontAndColorEvents .
L'ide chiama le modifiche seguenti dell'utente di metodo appropriato della pagina di Tipi di carattere e colori . Ad esempio, chiama il metodo di OnFontChanged se una nuova il tipo di carattere è selezionata.
In alternativa
Il polling dell'IDE per le modifiche.
Questa operazione può essere eseguita tramite l'interfaccia sistema-implementata di IVsFontAndColorStorage . Sebbene principalmente per il supporto di persistenza, il metodo di GetItem possa essere utilizzato per ottenere il tipo di carattere e le informazioni sui colori per Visualizzare elementi. Per ulteriori informazioni, vedere Accedere alle impostazioni archiviate di colori e tipi di carattere.
Nota
Per assicurarsi che i risultati ottenuti tramite polling sono corretti, può essere utile utilizzare l'interfaccia di IVsFontAndColorCacheManager per determinare se uno svuotamento e un aggiornamento della cache sono necessari prima di chiamare i metodi di recupero dell'interfaccia di IVsFontAndColorStorage .
Vedere anche
Attività
Procedura: Accedere ai tipi di carattere e la combinazione colori incorporate
Riferimenti
IVsFontAndColorDefaultsProvider
Concetti
Ottenere il tipo di carattere e informazioni sui colori per la colorazione del testo
Accedere alle impostazioni archiviate di colori e tipi di carattere