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, Nullable<Double>, Nullable<Double>) | 格式化并显示文本缓冲区的内容,以便 ITextViewLine 将包含  | 
| DisplayTextLineContainingBufferPosition(SnapshotPoint, Double, ViewRelativePosition) | 格式化并显示文本缓冲区的内容,以便 ITextViewLine 将包含  | 
| GetTextElementSpan(SnapshotPoint) | SnapshotSpan获取在给定 SnapshotPoint处构成文本元素 (单个视觉表示形式) 的文本的 。 | 
| GetTextViewLineContainingBufferPosition(SnapshotPoint) | ITextViewLine获取包含指定文本缓冲区位置的 。 | 
| QueueSpaceReservationStackRefresh() | 请求刷新空间预留堆栈。 | 
事件
| Closed | 在文本视图关闭后立即发生。 | 
| GotAggregateFocus | 当键盘焦点切换到视图或其装饰之一时发生。 | 
| LayoutChanged | 每当视图中显示的文本更改时发生。 | 
| LostAggregateFocus | 当键盘焦点离开视图及其任何装饰时发生。 | 
| MouseHover | 当鼠标悬停在同一个字符上时发生。 | 
| ViewportHeightChanged | 当视区的高度发生更改时发生。 | 
| ViewportLeftChanged | 当视区左边缘的位置发生更改时发生。 (例如,当视图水平滚动) | 
| ViewportWidthChanged | 在视区宽度更改时发生。 |