TextRanges - интерфейс

Статья
08/11/2011

Содержит объект TextRange для каждой из заключенных в теги частей выражения из шаблона поиска. TextRanges также служит для поиска места пересечения рамки выделения с каждой из строк текста.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
<GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")> _
Public Interface TextRanges _
    Inherits IEnumerable

[GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")]
public interface TextRanges : IEnumerable

[GuidAttribute(L"B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")]
public interface class TextRanges : IEnumerable

[<GuidAttribute("B6422E9C-9EFD-4F87-BDDC-C7FD8F2FD303")>]
type TextRanges =  
    interface
        interface IEnumerable
    end

public interface TextRanges extends IEnumerable

Тип TextRanges предоставляет следующие члены.

Свойства

	Имя	Описание
	Count	Возвращает значение, представляющее число объектов в коллекции.
	DTE	Возвращает объект расширения верхнего уровня.
	Parent	Возвращает непосредственный родительский объект для коллекции TextRanges.

В начало страницы

Методы

	Имя	Описание
	GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по элементам коллекции. (Унаследовано от IEnumerable.)
	GetEnumerator()	Возвращает перечисление элементов коллекции.
	Item	Возвращает объект TextRange в коллекции TextRanges.

В начало страницы

Заметки

Если шаблон поиска задан в виде регулярного выражения с подвыражениями, заключенными в теги, операцией поиска возвращается коллекция TextRanges. Коллекция TextRanges включает один объект TextRange для каждого из этих подвыражений.

Кроме того, если необходимо найти места пересечения прямоугольного выделения с каждой строкой, коллекция TextRanges используется для получения прямоугольных областей выделения из каждого объекта 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 - пространство имен

Поделиться через