實作自訂分類和顯示項目

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

VSPackage 可以提供控制項的字型和色彩，其文字的 Visual Studio 整合式的開發環境 (IDE) 透過自訂分類和顯示項目。

自訂分類與顯示的項目位於 字型和色彩 屬性頁。若要開啟 字型和色彩 屬性頁面上工具 ] 功能表上，按一下 [ 選項。展開環境然後按一下 [ 字型和色彩。

當使用這項機制，就必須實作 VSPackages IVsFontAndColorDefaultsProvider 介面和其相關聯的介面。

基本上，這項機制可以用來修改現有的所有 顯示項目 和類別，其中包含它們。不過，它不應修改 文字 EditorCategory 或其 顯示項目。如需詳細資訊，請參閱字型和色彩概觀。

若要實作自訂類別或 顯示項目, ，VSPackage 必須︰

若要建立或識別分類

建構一種特殊類型的類別下的登錄項目 [HKLM\SOFTWARE\Microsoft \Visual Studio\< Visual Studio 版本>\FontAndColors\<Category>]

< 類別> 為非當地語系化的類別目錄名稱。
填入具有兩個值的登錄︰

名稱類型資料描述

分類 REG_SZ GUID 識別類別 GUID。

封裝 REG_SZ GUID VSPackage 服務支援類別的 GUID。

名稱	類型	資料	描述
分類	REG_SZ	GUID	識別類別 GUID。
封裝	REG_SZ	GUID	VSPackage 服務支援類別的 GUID。

在登錄中指定的服務必須提供實作 IVsFontAndColorDefaults 對應分類。

建構一種特殊類型的類別下的登錄項目 [HKLM\SOFTWARE\Microsoft \Visual Studio\< Visual Studio 版本>\FontAndColors\< 群組>]

< 群組> 為非當地語系化的群組名稱。
填入具有兩個值的登錄︰

名稱類型資料描述

分類 REG_SZ GUID 建立識別群組的 GUID。

封裝 REG_SZ GUID 支援的類別目錄服務的 GUID。

名稱	類型	資料	描述
分類	REG_SZ	GUID	建立識別群組的 GUID。
封裝	REG_SZ	GUID	支援的類別目錄服務的 GUID。

在登錄中指定的服務必須提供實作 T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup 對應的群組。

實作 GetObject, ，這會傳回 IVsFontAndColorDefaults 介面或 T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup 介面，以針對每個 IDE 類別或群組提供的 GUID。
針對每個類別它支援、 VSPackage 實作的個別執行個體 IVsFontAndColorDefaults 介面。
透過實作方法 IVsFontAndColorDefaults 必須提供具有 IDE:
- 列出的 顯示項目 中 類別。
- 可當地語系化名稱 顯示項目。
- 顯示每個成員的資訊類別。
注意

每個類別必須包含至少一個 顯示項目。
IDE 會使用 T:Microsoft.VisualStudio.Shell.Interop.IVsFontAndColorGroup 介面來定義數種類別的聯集。

它的實作提供的 IDE:
- 一份類別組成特定的群組。
- 存取的執行個體 IVsFontAndColorDefaults 支援每個類別群組內。
- 可當地語系化的群組名稱。
正在更新 IDE:

IDE 會快取資訊的相關 字型和色彩 設定。因此，在任何修改的 IDE 之後 字型和色彩 組態，建議您先確認快取是最新。

更新快取透過 IVsFontAndColorCacheManager 介面，並可以執行全域或只在選取的項目。

若要正確支援 VSPackage 顯示文字的顏色標示，支援 VSPackage 的顏色標示服務必須回應使用者起始所做的變更透過 字型和色彩 屬性頁面。 VSPackage 做法是︰

藉由實作處理 IDE 所產生的事件 IVsFontAndColorEvents 介面。

IDE 會呼叫適當的方法，下列的使用者修改 字型和色彩 頁面。比方說，它會呼叫 OnFontChanged 方法，如果已選取新的字型。

-或-
輪詢變更 IDE。

這可以透過系統實作 IVsFontAndColorStorage 介面。雖然主要是為了支援持續性的 GetItem 方法可用來取得字型和色彩資訊 顯示項目。如需詳細資訊，請參閱存取儲存的字型和色彩設定。

注意

為了確保透過輪詢得到的結果是否正確，可能是適用於 IVsFontAndColorCacheManager 介面，以判斷是否需要快取排清及更新的擷取方法的呼叫之前 IVsFontAndColorStorage 介面。