TextRange - интерфейс

Статья
11/01/2012

Предоставляет отдельный фрагмент непрерывного текста в текстовом документе.

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

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

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