ITextView Интерфейс

Ссылка

Определение

Пространство имен:: Microsoft.VisualStudio.Text.Editor

Сборка:: Microsoft.VisualStudio.Text.UI.dll

Пакет:: Microsoft.VisualStudio.Text.UI v17.9.187

Важно!

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

Представляет представление текста в ITextBuffer. Это базовый класс для интерфейса для определенной платформы, содержащий методы, обеспечивающие отрисовку форматированного текста.

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner

public interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwner

type ITextView = interface
    interface IPropertyOwner

Public Interface ITextView
Implements IPropertyOwner

Производный: Microsoft.VisualStudio.Text.Editor.ITextView2

Microsoft.VisualStudio.Text.Editor.IWpfTextView

Реализации: IPropertyOwner

Текстовое представление — это независимое от платформы представление непрерывного блока отформатированного и украшенного текста, доступного через TextViewLines свойство . Он также создает экземпляр компонента IEditorOperations, чтобы он смог выполнять различные команды.

Текст форматируется на основе классификаторов, присоединенных к базовому ITextBufferобъекту .

Большинство свойств и параметров, которые являются двойными, соответствуют координатам или расстояниям в системе координат отрисовки текста. В этой системе координат x = 0,0 соответствует левому краю поверхности рисования, на которой выполняется отрисовка текста (x = view. ViewportLeft соответствует левому краю окна просмотра), а y — представлению. ViewportTop соответствует верхнему краю окна просмотра. Координата X увеличивается слева направо, а координата Y — сверху вниз.

Горизонтальная и вертикальная оси представления ведут себя по-разному. При форматировании текста в представлении форматируются только видимые строки. В результате окно просмотра не может быть прокручено по горизонтали и вертикали одинаково.

Окно просмотра прокручивается горизонтально путем изменения левой координаты окна просмотра таким образом, чтобы оно перемещалось относительно поверхности рисования.

Представление можно прокручивать по вертикали только с помощью нового макета.

Создание макета в представлении может привести к изменению свойства ViewportTop представления. Например, прокрутка вниз на одну строку не приведет к преобразованию каких-либо видимых линий. Вместо этого он просто изменит свойство ViewportTop представления (в результате чего линии будут перемещаться по экрану, даже если их координаты по оси Y не изменились).

Расстояния в системе координат отрисовки текста соответствуют логическим пикселям. Если поверхность отрисовки текста отображается без преобразования масштабирования, то 1 единица в системе координат отрисовки текста соответствует одному пикселю на дисплее.

Свойства

BufferGraph	Получает объект IBufferGraph, содержащий набор исходных буферов, использующихся в данном представлении.
Caret	Получает элемент курсора.
HasAggregateFocus	Определяет, есть ли фокус у представления или какого-либо из его оформлений.
InLayout	Определяет, находится ли представление в процессе формирования макета.
IsClosed	Определяет, закрыто ли данное представление текста.
IsMouseOverViewOrAdornments	Определяет, находится ли указатель мыши над просмотром или каким-либо из его оформлений.
LineHeight	Получает номинальную высоту строки текста в представлении.
MaxTextRightCoordinate	Получает правую координату самой длинной строки в логических пикселях, независимо от того, видна ли данная строка в настоящий момент.
Options	Получает параметры для данного представления текста.
Properties	Коллекция свойств, управляемая владельцем свойств. (Унаследовано от IPropertyOwner)
ProvisionalTextHighlight	Получает диапазон текста с выделением подготовленного текста.
Roles	Роли, которые играет данное представление. Роли отчасти определяют расширения, экземпляры которых создаются для представления.
Selection	Получает элемент выделения.
TextBuffer	Получает буфер ITextBuffer, текст которого отрисовывается в данном представлении.
TextDataModel	Получает модель ITextDataModel данного представления текста.
TextSnapshot	Получает снимок ITextSnapshot текста, который в настоящее время отрисовывается в представлении.
TextViewLines	Получает список, доступный только для чтения, объектов ITextViewLine, отрисовываемых в данном представлении.
TextViewModel	Получает модель ITextViewModel данного представления текста.
ViewportBottom	Возвращает положение нижнего края окна просмотра в системе координат отрисовки текста.
ViewportHeight	Возвращает высоту окна видимого содержимого в логических пикселях.
ViewportLeft	Возвращает или задает положение левого края окна просмотра в системе координат отрисовки текста.
ViewportRight	Возвращает положение правого края окна просмотра в системе координат отрисовки текста.
ViewportTop	Возвращает положение верхнего края окна просмотра в системе координат отрисовки текста.
ViewportWidth	Возвращает ширину окна видимого содержимого в логических пикселях.
ViewScroller	Получает вспомогательный объект, предоставляющий различные методы для прокрутки или управления представлением.
VisualSnapshot	Получает снимок ITextSnapshot отрисовываемого визуального буфера.

Методы

Close()	Закрывает текстовое представление и его представление.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition)	Форматирует и отображает содержимое текстового буфера таким образом, чтобы ITextViewLine содержащий `bufferPosition` объект отображался в нужной позиции.
DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	Форматирует и отображает содержимое текстового буфера таким образом, чтобы ITextViewLine содержащий `bufferPosition` объект отображался в нужной позиции.
GetTextElementSpan(SnapshotPoint)	Получает снимок SnapshotSpan текста, составляющий текстовый элемент (одно визуальное представление) в данной точке SnapshotPoint.
GetTextViewLineContainingBufferPosition(SnapshotPoint)	Получает объект ITextViewLine, содержащий указанное положение текстового буфера.
QueueSpaceReservationStackRefresh()	Запрашивает обновление стека резервирования пробелов.

События

Closed	Возникает сразу после закрытия представления текста.
GotAggregateFocus	Возникает при переходе фокуса клавиатуры на представление или одно из его оформлений.
LayoutChanged	Происходит при каждом изменении текста, отображаемого в представлении.
LostAggregateFocus	Возникает при переходе фокуса клавиатуры с представления и любого из его оформлений.
MouseHover	Происходит при наведении указателя мыши на тот же символ.
ViewportHeightChanged	Происходит при изменении высоты окна просмотра.
ViewportLeftChanged	Происходит при изменении положения левого края окна просмотра. (например, при горизонтальной прокрутке представления)
ViewportWidthChanged	Происходит при изменении ширины окна просмотра.

Методы расширения

GetInOuterLayout(ITextView)	Определяет, находится ли точка зрения в процессе составления или готовится к изложению.
GetMultiSelectionBroker(ITextView)	Возвращает объект для управления выделенными фрагментами в представлении.
IsEmbeddedTextView(ITextView)	Возвращает значение, указывающее, внедрено ли данное ITextView значение в другой ITextViewобъект .
IsReadOnlyTextView(ITextView)	Возвращает значение, указывающее, считается ли данное ITextView значение доступом только для чтения.
QueuePostLayoutAction(ITextView, Action)	См. раздел QueuePostLayoutAction(Action).
TryGetContainingTextView(ITextView, ITextView)	Возвращает , ITextView содержащий для заданного внедренного ITextView.
TryGetTextViewLineContainingBufferPosition(ITextView, SnapshotPoint, ITextViewLine)	См. раздел TryGetTextViewLineContainingBufferPosition(SnapshotPoint, ITextViewLine).
TryGetTextViewLines(ITextView, ITextViewLineCollection)	См. раздел TryGetTextViewLines(ITextViewLineCollection).

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