使用編輯器項目範本建立延伸模組

  • 發行項

您可以使用 Visual Studio SDK 內含的項目範本來建立基本編輯器延伸模組，將分類器、裝飾和邊界新增至編輯器。 編輯器項目範本適用於 Visual C# 或 Visual Basic VSIX 專案。

建立分類器延伸模組

編輯器分類器項目範本會建立編輯器分類器，在任何文字檔中為適當的文字著色 (在本例中為所有文字)。

  1. 在 [新增專案] 對話方塊中，展開 [Visual C#] 或 [Visual Basic]，然後按一下 [擴充性]。 在 [範本] 窗格中，選取 [VSIX 專案]。 在 [名稱] 方塊中，輸入 TestClassifier。 按一下 [確定]。

  2. 在 [方案總管] 中，以滑鼠右鍵按一下專案節點，並選取 [新增]>[新增項目]。 移至 Visual C# [擴充性] 節點，然後選取 [編輯器分類器]。 保留預設檔名 (EditorClassifier1.cs)。

  3. 有四個程式碼檔案，如下所示：

    • EditorClassifier1.cs 包含 EditorClassifier1 類別。

    • EditorClassifier1ClassificationDefinition.cs 包含 EditorClassifier1ClassificationDefinition 類別。

    • EditorClassifier1Format.cs 包含 EditorClassifier1Format 類別。

    • EditorClassifier1Provider.cs 包含 EditorClassifier1Provider 類別。

  4. 建置此專案並開始偵錯。 隨即出現 Visual Studio 實驗執行個體。

    如果您開啟文字檔，所有文字都會有紫色背景並加上底線。

建立文字相關裝飾延伸模組

編輯器文字裝飾範本會使用具有紅色外框和藍色背景的方塊，建立文字相關裝飾，以裝飾文字字元 'a' 的所有例項。 此為文字相關，因為方塊一律會重疊 'a' 字元，即使它們已移動或重新格式化也一樣。

  1. 在 [新增專案] 對話方塊中，展開 [Visual C#] 或 [Visual Basic]，然後按一下 [擴充性]。 在 [範本] 窗格中，選取 [VSIX 專案]。 在 [名稱] 方塊中，輸入 TestAdornment。 按一下 [確定]。

  2. 在 [方案總管] 中，以滑鼠右鍵按一下專案節點，並選取 [新增]>[新增項目]。 移至 Visual C# [擴充性] 節點，然後選取 [編輯器文字裝飾]。 保留預設檔名 (TextAdornment1.cs/vb)。

  3. 有兩個程式碼檔案，如下所示：

    • TextAdornment1.cs 包含 TextAdornment1 類別。

    • TextAdornment1TextViewCreationListener.cs 包含 TextAdornment1TextViewCreationListener 類別。

  4. 建置此專案並開始偵錯。 隨即出現實驗執行個體。 如果您開啟文字檔，文字中的所有 'a' 字元都會有紅色外框和藍色背景。

建立檢視區相關裝飾延伸模組

編輯器檢視區裝飾範本會建立檢視區相關裝飾，這會新增一個在檢視區右上角有紅色外框的紫色方塊。

注意

檢視區是目前顯示的文字檢視區域。

使用編輯器檢視區裝飾範本建立檢視區裝飾延伸模組

  1. 在 [新增專案] 對話方塊中，展開 [Visual C#] 或 [Visual Basic]，然後按一下 [擴充性]。 在 [範本] 窗格中，選取 [VSIX 專案]。 在 [名稱] 方塊中，輸入 ViewportAdornment。 按一下 [確定]。

  2. 在 [方案總管] 中，以滑鼠右鍵按一下專案節點，並選取 [新增]>[新增項目]。 移至 Visual C# [擴充性] 節點，然後選取 [編輯器檢視區裝飾]。 保留預設檔名 (ViewportAdornment1.cs/vb)。

  3. 有兩個程式碼檔案，如下所示：

    • ViewportAdornment1.cs 包含 ViewportAdornment1 類別。

    • ViewportAdornment1TextViewCreationListener.cs 包含 ViewportAdornment1TextViewCreationListener 類別

  4. 建置此專案並開始偵錯。 隨即出現實驗執行個體。 如果您建立新的文字檔，則會在檢視區右上角顯示具有紅色外框的紫色方塊。

建立邊界延伸模組

編輯器邊界範本會建立綠色邊界，與 *Hello world! 一詞一起出現在水平捲軸下方。

使用編輯器邊界範本建立邊界延伸模組

  1. 在 [新增專案] 對話方塊中，展開 [Visual C#] 或 [Visual Basic]，然後按一下 [擴充性]。 在 [範本] 窗格中，選取 [VSIX 專案]。 在 [名稱] 方塊中，輸入 MarginExtension。 按一下 [確定]。

  2. 在 [方案總管] 中，以滑鼠右鍵按一下專案節點，並選取 [新增]>[新增項目]。 移至 Visual C# [擴充性] 節點，然後選取 [編輯器邊界]。 保留預設檔名 (EditorMargin1.cs/vb)。

  3. 有兩個程式碼檔案，如下所示：

    • EditorMargin1.cs 包含 EditorMargin1 類別。

    • EditorMargin1Factory.cs 包含 EditorMargin1Factory 類別。

  4. 建置此專案並開始偵錯。 隨即出現實驗執行個體。 如果您開啟文字檔，水平捲軸下方會顯示具有 Hello EditorMargin1 一詞的綠色邊界。

相關內容