TextPoint - интерфейс

Статья
05/17/2015

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

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

Синтаксис

'Декларация
<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")> _
Public Interface TextPoint

[GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface TextPoint

[GuidAttribute(L"7F59E94E-4939-40D2-9F7F-B7651C25905D")]
public interface class TextPoint

[<GuidAttribute("7F59E94E-4939-40D2-9F7F-B7651C25905D")>]
type TextPoint =  interface end

public interface TextPoint

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

Свойства

	Имя	Описание
	AbsoluteCharOffset	Возвращает смещение знака с начала документа до объекта TextPoint.
	AtEndOfDocument	Возвращает значение, если объект находится в конце документа.
	AtEndOfLine	Возвращает, находится ли объект в конце линии.
	AtStartOfDocument	Возвращает, находится ли объект в начале документа.
	AtStartOfLine	Возвращает, находится ли объект в начале строки.
	CodeElement	Возвращает элемент кода с расположением TextPoint.
	DisplayColumn	Возвращает номер выделенного в настоящий момент столбца, содержащего объект TextPoint.
	DTE	Возвращает объект расширения верхнего уровня.
	Line	Получает номер строки объекта.
	LineCharOffset	Возвращает смещение знаков объекта.
	LineLength	Возвращает число знаков в строке, которая содержит объект, за исключением знака новой строки.
	Parent	Получает непосредственный родительский объект для объекта TextPoint.

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

Методы

	Имя	Описание
	CreateEditPoint	Создает и возвращает объект EditPoint в расположении вызывающего объекта.
	EqualTo	Возвращает, равно ли значение данной точки свойства AbsoluteCharOffset объекта вызывающему объекту TextPoint.
	GreaterThan	Указывает, больше ли значение свойства AbsoluteCharOffset вызывающего объекта, чем данного объекта точки.
	LessThan	Указывает, меньше ли значение свойства AbsoluteCharOffset вызываемого объекта, чем данного объекта.
	TryToShow	Пытается отобразить положение точки текста.

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

Заметки

Объект TextPoint позволяет находить место расположения тех или иных элементов в документе. Используя свойства объекта TextPoint, можно искать текст по:

Номерам строк.
Числу знаков в строке.
Абсолютному числу знаков от начала документа.
Отображаемым столбцам.

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

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

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

Примеры

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

См. также

Ссылки

EnvDTE - пространство имен

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