Represents a single, contiguous section of text in a text document.
Assembly: EnvDTE (in EnvDTE.dll)
Thetype exposes the following members.
|Collection||Gets the collection containing the object supporting this property.|
|DTE||Gets the top-level extensibility object.|
|EndPoint||Gets an EditPoint that is the location of the end of the range.|
|StartPoint||Gets the EditPoint object representing the beginning of the text document, or the first displayed character of the pane.|
The section of text is enclosed by a pair of EditPoint objects.
objects are used when you have regular expressions with tagged subexpressions. A collection of ranges is returned, one for each matched subexpression, and their properties are read-only.
For general text manipulation, it is recommended that you instead use objects such as TextSelection or EditPoint, because the TextSelection object relates directly to the selection visible on the screen. When the selection area changes, the object's coordinates change, and vice-versa. As a result, a text selection cannot be used to represent an arbitrary range of text without disrupting that text selection.
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