TextPoint Интерфейс

Определение

Представляет расположение текста в текстовом документе.

public interface class TextPoint
public interface class TextPoint
__interface TextPoint
[System.Runtime.InteropServices.Guid("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface TextPoint
[<System.Runtime.InteropServices.Guid("7F59E94E-4939-40D2-9F7F-B7651C25905D")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type TextPoint = interface
Public Interface TextPoint
Производный
Атрибуты

Примеры

Sub TextPointExample()  
   ' Comments a region of code.  
   Dim selection As TextSelection  
   selection = dte.ActiveDocument.selection()  
   Dim Start As Editpoint  
   Start = selection.TopPoint.CreateEditPoint()  
   Dim endpt As TextPoint endpt = selection.BottomPoint  

   Dim undoObj As UndoContext = dte.UndoContext  
   undoobj.Open("Comment Region")  
   Do While (Start.LessThan(endpt))  
      Start.Insert("//")  
      Start.LineDown()  
      Start.StartOfLine()  
   Loop  
   undoobj.Close()  
End Sub  

Комментарии

TextPointОбъект позволяет находить расположения в документе. С помощью свойств TextPoint объекта можно найти текст с помощью:

  • Номера строк

  • Номера символов в строке

  • Абсолютные расположения символов с начала документа

  • Отображение столбцов

TextPoint объекты похожи на EditPoint объекты, за исключением того, что они работают с текстом, отображаемым в редакторе кода, а не с данными в текстовом буфере. На текст в документе влияют глобальные состояния редактора, такие как перенос по словам и виртуальные пробелы, но не текстовый буфер.

При редактировании документа TextPoint объекты не перемещаются относительно окружающего их текста. То есть, если текст вставляется перед текстовой точкой, значение его AbsoluteCharOffset Свойства увеличивается, чтобы отразить его новое расположение в документе. Если несколько TextPoint объектов находятся в одном расположении, а EditPoint объект используется для вставки нового текста, то новые символы будут находиться справа от всех TextPoint объектов, за исключением того, что он использовался для вставки текста.

Любая операция, которая пытается изменить TextDocument объект, завершается ошибкой, если TextDocument доступна только для чтения.

Свойства

AbsoluteCharOffset

Возвращает смещение знака с начала документа до объекта TextPoint.

AtEndOfDocument

Возвращает значение, если объект находится в конце документа.

AtEndOfLine

Возвращает, находится ли объект в конце линии.

AtStartOfDocument

Возвращает, находится ли объект в начале документа.

AtStartOfLine

Возвращает, находится ли объект в начале строки.

CodeElement[vsCMElement]

Возвращает элемент кода с расположением TextPoint.

DisplayColumn

Возвращает номер выделенного в настоящий момент столбца, содержащего объект TextPoint.

DTE

Возвращает объект расширения верхнего уровня.

Line

Получает номер строки объекта.

LineCharOffset

Возвращает смещение знаков объекта.

LineLength

Возвращает число знаков в строке, которая содержит объект, за исключением знака новой строки.

Parent

Возвращает ближайший родительский объект для объекта TextPoint.

Методы

CreateEditPoint()

Создает и возвращает объект EditPoint в расположении вызывающего объекта.

EqualTo(TextPoint)

Возвращает, равно ли значение данной точки свойства AbsoluteCharOffset объекта вызывающему объекту TextPoint.

GreaterThan(TextPoint)

Указывает, больше ли значение свойства AbsoluteCharOffset вызывающего объекта, чем данного объекта точки.

LessThan(TextPoint)

Указывает, меньше ли значение свойства AbsoluteCharOffset вызываемого объекта, чем данного объекта.

TryToShow(vsPaneShowHow, Object)

Пытается отобразить положение точки текста.

Применяется к