ITextView 接口
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 中文本的 ITextBuffer视图。 它是平台特定接口的基类，该接口具有允许呈现格式化文本的方法。
public interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwnerpublic interface class ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwner__interface ITextView : Microsoft::VisualStudio::Utilities::IPropertyOwnerpublic interface ITextView : Microsoft.VisualStudio.Utilities.IPropertyOwnertype ITextView = interface
interface IPropertyOwnerPublic Interface ITextView
Implements IPropertyOwner- 派生
- 实现
注解
文本视图是格式化和装饰文本的连续块（可通过 属性访问）的独立于平台的 TextViewLines 表示形式。 它还实例化 IEditorOperations 组件部件的实例，以便它可以执行各种命令。
文本的格式基于附加到基础 ITextBuffer的分类器进行格式设置。
大多数双精度属性和参数对应于文本呈现坐标系中的坐标或距离。 在此坐标系中，x = 0.0 对应于 (x = 视图呈现文本的绘图图面的左边缘。ViewportLeft 对应于视区) 的左边缘，y = 视图。ViewportTop 对应于视区上边缘。 x 坐标从左到右增加，y 坐标从上到下增加。
视图的水平轴和垂直轴的行为不同。 设置视图中的文本格式时，仅设置可见行的格式。 因此，无法以相同的方式水平和垂直滚动视区。
通过更改视区左坐标水平滚动视区，使其相对于绘图图面移动。
只能通过执行新布局来垂直滚动视图。
在视图中执行布局可能会导致视图的 ViewportTop 属性发生更改。 例如，向下滚动一行不会转换任何可见行。 相反，它只会更改视图的 ViewportTop 属性， (导致线条在屏幕上移动，即使其 y 坐标没有更改) 。
文本呈现坐标系中的距离对应于逻辑像素。 如果在不进行任何缩放转换的情况下显示文本呈现图面，则文本呈现坐标系中的 1 个单位对应于显示器上的一个像素。
属性
| BufferGraph |
IBufferGraph获取包含此视图的源缓冲区集的 。 |
| Caret |
获取插入点元素。 |
| HasAggregateFocus |
确定视图或其任何装饰是否具有焦点。 |
| InLayout |
确定视图是否处于布局过程中。 |
| IsClosed |
确定此文本视图是否已关闭。 |
| IsMouseOverViewOrAdornments |
确定鼠标是否位于视图或其任何装饰上。 |
| LineHeight |
获取视图中文本行的名义高度。 |
| MaxTextRightCoordinate |
获取最长线条的右坐标，无论该线条当前是否可见，以逻辑像素表示。 |
| Options |
获取此文本视图的选项。 |
| Properties |
由属性所有者控制的属性集合。 (继承自 IPropertyOwner) |
| ProvisionalTextHighlight |
获取临时文本突出显示所覆盖的文本范围。 |
| Roles |
此视图所扮演的角色。 角色部分确定为视图实例化的扩展。 |
| Selection |
获取 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获取在给定 SnapshotPoint处构成文本元素 (单个视觉表示形式) 的文本的 。 |
| GetTextViewLineContainingBufferPosition(SnapshotPoint) |
ITextViewLine获取包含指定文本缓冲区位置的 。 |
| QueueSpaceReservationStackRefresh() |
请求刷新空间预留堆栈。 |
事件
| Closed |
在文本视图关闭后立即发生。 |
| GotAggregateFocus |
当键盘焦点切换到视图或其装饰之一时发生。 |
| LayoutChanged |
每当视图中显示的文本更改时发生。 |
| LostAggregateFocus |
当键盘焦点离开视图及其任何装饰时发生。 |
| MouseHover |
当鼠标悬停在同一个字符上时发生。 |
| ViewportHeightChanged |
当视区的高度发生更改时发生。 |
| ViewportLeftChanged |
当视区左边缘的位置发生更改时发生。 (例如，当视图水平滚动) |
| ViewportWidthChanged |
在视区宽度更改时发生。 |