如何︰ 展開大綱中提供支援舊版語言服務

 

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

有兩個選項，來擴充您的語言支援的大綱支援摺疊至定義命令。 您可以新增編輯器控制大綱區域，以及新增用戶端控制大綱區域。

加入編輯器控制大綱區域

使用這種方法來建立大綱區域，然後讓處理是否展開區域時，編輯器摺疊，等等。 此選項提供大綱支援兩個選項，是最不穩固。 此選項時，您必須建立新的大綱區域一段指定的時間範圍的文字使用AddOutlineRegions。 此區域建立之後，其行為會受到編輯器] 中。 您可以使用下列程序來實作編輯器控制大綱區域。

若要實作一個編輯器控制大綱區域

1. 呼叫QueryService的SVsTextManager

   這會傳回指標IVsHiddenTextManager。

2. 呼叫GetHiddenTextSession，並傳入指定的文字緩衝區的指標。 這會傳回指標IVsHiddenTextSession緩衝區的物件。

3. 呼叫QueryInterface上IVsHiddenTextSession指標IVsOutliningSession。

4. 呼叫AddOutlineRegions加入一個或多新增一次大綱區域。

   這個方法可讓您指定的大綱、 移除或保留現有的大綱區域是否和大綱區域是否為展開或摺疊的預設值的文字範圍。

新增用戶端控制大綱區域

使用這個方法來實作，用戶端控制 （或智慧型） 大綱喜歡使用Visual C#和Visual Basic語言服務。 語言服務，可管理自己的大綱監視文字緩衝區內容，以摧毀舊的大綱區域，他們就會變成無效時，並視需要建立新的大綱區域。

若要實作的用戶端控制大綱區域

1. 呼叫QueryService的SVsTextManager。 這會傳回指標IVsHiddenTextManager。

2. 呼叫GetHiddenTextSession，並傳入指定的文字緩衝區的指標。 這會決定是否隱藏的文字工作階段已經存在的緩衝區。

3. 如果文字工作階段已經存在，則不需要建立一個，並指向現有的IVsHiddenTextSession會傳回物件。 使用此指標來列舉並建立大綱區域。 否則，呼叫CreateHiddenTextSession建立隱藏的文字工作階段的緩衝區。 指標IVsHiddenTextSession會傳回物件。

   注意

   當您呼叫CreateHiddenTextSession，您可以指定隱藏的文字，用戶端 (也就是IVsHiddenTextClient物件)。 此用戶端通知時隱藏文字，或是展開或摺疊，只要使用者大綱區域。

4. 呼叫AddHiddenRegions結構) 參數︰ 指定的值為hrtCollapsible中iType成員NewHiddenRegion結構，以指出您要建立一個大綱區域，而不是隱藏的區域。 指定的區域是用戶端控制，或在編輯器控制dwBehavior成員NewHiddenRegion結構。 智慧型的大綱實作可以包含混合的編輯器和用戶端控制大綱區域。 指定大綱區域摺疊時，例如"..."，在顯示的橫幅文字pszBanner成員NewHiddenRegion結構。 編輯器的隱藏區域的預設橫幅文字是"..."。