自訂色彩的項目
如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。
您可以覆寫類型的清單的色彩標示、 關鍵字和註解,例如實作自訂色彩的項目做為語言服務的一部分。
使用者設定的色彩的項目
您可以顯示字型和色彩] 對話方塊中,選取 [選項上工具] 功能表,然後選取 [字型和色彩下環境。 當您選取顯示,例如文字編輯器或命令視窗、顯示項目清單方塊會顯示可顯示的所有可設定色彩的項目。 您可以檢視及變更字型、 大小、 前景色彩和每個色彩項目的背景色彩。 您可以選擇在登錄中快取存放及存取依色彩項目的名稱。
項目色彩的呈現方式
因為 IDE 處理色彩的項目中的使用者覆寫字型和色彩對話方塊,您需要僅提供每個自訂色彩項目的名稱。 此名稱都會顯示於顯示項目清單。 依字母順序顯示色彩的項目。 語言服務的自訂色彩的項目分組,您就可以開始每個名稱和您語言的名稱,例如NewLanguage-註解和NewLanguage-關鍵字。
注意
您應該避免與現有色彩項目的名稱衝突的色彩項目的名稱包含語言名稱。 如果您在開發期間變更其中一個色彩的項目名稱,您必須重設快取所建立的第一次您可設定色彩的項目可供存取。 您可以重設其 CreateExpInstance 工具,它會隨 Visual Studio SDK,通常在目錄中的實驗性快取
C:\Program 檔案 (x86) \Microsoft Visual Studio 14.0\VSSDK\VisualStudioIntegration\Tools\Bin
若要重設快取,請呼叫CreateExpInstance /Reset
。 如需 CreateExpInstance 的詳細資訊,請參閱CreateExpInstance 公用程式。
永遠不會參考可設定色彩的項目在清單中第一個項目。 第一個項目會對應到色彩項目的索引為 0,和Visual Studio一律會提供的預設文字色彩和該項目的屬性。 最簡單的方式來處理此未參考的項目會提供預留位置色彩項目的第一個項目清單中。
實作自訂色彩的項目
定義什麼必須以您的語言,例如關鍵字、 運算子和識別項。
建立這些色彩項目的列舉。
建立關聯的剖析器或掃描器的列舉值傳回的權杖型別。
例如,代表權杖類型的值可能是自訂色彩的項目列舉型別中相同的值。
在您實作ColorizeLine方法,在您IVsColorizer物件,從您對應至從剖析器或掃描器傳回的權杖類型的自訂色彩的項目列舉值來填入屬性清單。
在相同類別中實作IVsLanguageInfo介面,請實作IVsProvideColorableItems介面和其兩個方法︰ GetItemCount和GetColorableItem。
實作IVsColorableItem介面。
如果您想要支援 24 位元或高的色彩值,也必須實作IVsHiColorItem介面。
在您語言的服務物件,建立一個清單,其中包含您IVsColorableItem物件、 一個用於您的剖析器或掃描器可以識別每個色彩的項目。
您可以使用自訂色彩的項目列舉型別對應的值來存取清單中的每個項目。 使用做為索引的列舉值清單中。 在清單中的第一個項目永遠不會存取,因為它會對應至預設的文字設定樣式Visual Studio永遠會處理本身。 您可以為了彌補這一點預留位置色彩的項目插入清單的開頭。
在您實作GetItemCount方法,傳回自訂色彩的項目清單中的項目數。
在您實作GetColorableItem方法,傳回要求之色彩的項目從您的清單。
如需如何實作IVsColorableItem和IVsHiColorItem介面,請參閱IVsHiColorItem。