ITextView 接口

表示 ITextBuffer 中文本的视图。 该类是平台特定接口的基类，具有用于呈现格式化文本的方法。

命名空间：  Microsoft.VisualStudio.Text.Editor
程序集：  Microsoft.VisualStudio.Text.UI（在 Microsoft.VisualStudio.Text.UI.dll 中）

语法

声明
Public Interface ITextView _
    Inherits IPropertyOwner

public interface ITextView : IPropertyOwner

public interface class ITextView : IPropertyOwner

type ITextView =  
    interface 
        interface IPropertyOwner 
    end

public interface ITextView extends IPropertyOwner

ITextView 类型公开以下成员。

属性

	名称	说明
	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 显示在合适的位置。
	DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)	格式化和显示文本缓冲区的内容，以便包含指定缓冲区位置的 ITextViewLine 显示在合适的位置。
	GetTextElementSpan	在指定 SnapshotPoint 获取构成文本元素（单一可视化表示形式）的文本 SnapshotSpan。
	GetTextViewLineContainingBufferPosition	获取包含指定文本缓冲区位置的 ITextViewLine。
	QueueSpaceReservationStackRefresh	请求刷新空间保留堆栈。

页首

事件

	名称	说明
	Closed	在关闭文本视图后立即发生。
	GotAggregateFocus	在键盘焦点切换到该视图或其修饰之一时发生。
	LayoutChanged	在文本编辑器执行文本行布局时发生。
	LostAggregateFocus	在键盘焦点离开该视图及其所有修饰时发生。
	MouseHover	，当鼠标悬停在字符，发生。
	ViewportHeightChanged	，更改，发生视区高度。已否决。
	ViewportLeftChanged	，当更改时发生，视区左边缘的位置。已弃用
	ViewportWidthChanged	，更改，发生视区宽度。已否决。

页首

备注

文本视图是一个独立于平台的表示精简了格式的和所装饰的文本。 该文本可以 TextViewLines 属性访问。

有关文本视图的更多信息，请参见一节 “文本视图”中 在编辑器内。

文本视图还实例化 IEditorOperations 组成部分的实例，使其能执行不同的命令。

该文本格式根据附加到基础 ITextBuffer的分类器。

为 double 的大多数属性和参数对应于坐标或在距离 (以文本呈现坐标系表示)。 此坐标系统中， x = 0.0 对应于绘制的左边缘图面在哪个文本上呈现 (x = view.ViewportLeft 对应于视区左边缘)，因此， y = view.ViewportTop 对应于视区上边缘。 该 x 坐标从上往下从左至右递增和 y 坐标增加。 视图的水平和垂直轴有不同的行为。 当在视图中设置文本格式，因此，只有可见行设置。 因此，视区不能水平和垂直类似地移动。 视区通过将视区左边坐标水平移动，使其移动有关离绘图图面。 视图可以通过执行新的布局仅移动垂直。 执行在视图的格式可能导致视图的 ViewportTop 属性更改。

例如，下移一行不会将任何可见的行。 而是将更改 ViewportTop 属性，在屏幕上移动导致行，即使它们的 y 坐标未发生更改。 在以文本呈现坐标系表示) 的距离对应于逻辑像素为单位。 如果文本呈现图面显示，而无需任何缩放转换，则以文本呈现坐标系表示) 的一个单元对应于在显示的一个像素。

请参阅

参考

Microsoft.VisualStudio.Text.Editor 命名空间