TextRange 介面

代表文字文件中單一且連續的文字區段。

命名空間：  EnvDTE
組件：  EnvDTE (在 EnvDTE.dll 中)

語法

'宣告
<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")> _
Public Interface TextRange

[GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface TextRange

[GuidAttribute(L"72767524-E3B3-43D0-BB46-BBE1D556A9FF")]
public interface class TextRange

[<GuidAttribute("72767524-E3B3-43D0-BB46-BBE1D556A9FF")>]
type TextRange =  interface end

public interface TextRange

TextRange 型別會公開下列成員。

屬性

	名稱	說明
	Collection	取得集合，此集合包含支援此屬性的 TextRange 物件。
	DTE	取得最上層的擴充性物件。
	EndPoint	取得表示範圍結束位置的 EditPoint。
	StartPoint	取得 EditPoint 物件，表示文字文件的開頭，或是窗格的第一個顯示字元。

回頁首

備註

此文字區段會放在一對 EditPoint 物件中。

TextRange 物件是在您具有包含標記子運算式的規則運算式 (Regular Expression) 時使用。 傳回範圍的集合 (一個集合對一個符合的子運算式)，而且它們的屬性都是唯讀的。

對於一般的文字管理，建議您使用 TextSelection 或 EditPoint 等物件，因為 TextSelection 物件是直接與螢幕上可見的選取範圍相關。 當選取範圍變更時，該物件的座標也會改變，反之亦然。 因此，無法使用文字的選取範圍表示文字的任意範圍，而不干擾到該文字的選取範圍。

範例

Sub TextRangeExample(ByVal dte As EnvDTE.DTE)
    Dim objTxtSel As TextSelection
    Dim colRanges As TextRanges
    Dim objRange As TextRange
    Dim objEP As EditPoint

    objTxtSel = dte.ActiveDocument.Selection
    colRanges = objTxtSel.TextRanges
    For Each objRange In colRanges
        objRange.StartPoint.Insert("/*")
        objRange.EndPoint.Insert("*/")
    Next
End Sub

public void TextRangeExample(_DTE dte)
{
    TextSelection ts;
    TextRanges trs;

    ts = (TextSelection)dte.ActiveDocument.Selection;
    trs = ts.TextRanges;
    MessageBox.Show (trs.Count.ToString ());
    foreach (TextRange tr in trs)
    {
        tr.StartPoint.Insert ("/*");
        tr.EndPoint.Insert ("*/");
    }
}

請參閱

參考

EnvDTE 命名空間