ITextViewLineCollection 接口

定义

命名空间:

Microsoft.VisualStudio.Text.Editor

程序集:

Microsoft.VisualStudio.Text.UI.dll

包:

Microsoft.VisualStudio.Text.UI v17.9.187

表示用于访问视图的对象集合的 ITextViewLine 帮助程序类。 上的 ITextView TextViewLines 属性用于获取此接口的实例。

public interface class ITextViewLineCollection : System::Collections::Generic::ICollection<Microsoft::VisualStudio::Text::Formatting::ITextViewLine ^>, System::Collections::Generic::IEnumerable<Microsoft::VisualStudio::Text::Formatting::ITextViewLine ^>, System::Collections::Generic::IList<Microsoft::VisualStudio::Text::Formatting::ITextViewLine ^>

public interface ITextViewLineCollection : System.Collections.Generic.ICollection<Microsoft.VisualStudio.Text.Formatting.ITextViewLine>, System.Collections.Generic.IEnumerable<Microsoft.VisualStudio.Text.Formatting.ITextViewLine>, System.Collections.Generic.IList<Microsoft.VisualStudio.Text.Formatting.ITextViewLine>

type ITextViewLineCollection = interface
    interface IList<ITextViewLine>
    interface ICollection<ITextViewLine>
    interface seq<ITextViewLine>
    interface IEnumerable

Public Interface ITextViewLineCollection
Implements ICollection(Of ITextViewLine), IEnumerable(Of ITextViewLine), IList(Of ITextViewLine)

派生

Microsoft.VisualStudio.Text.Editor.IWpfTextViewLineCollection

实现

ICollection<ITextViewLine> ICollection<T> IEnumerable<ITextViewLine> IEnumerable<T> IList<ITextViewLine> IEnumerable

注解

每次生成新布局时， 都会 ITextView 释放其 ITextViewLineCollection 及其包含的所有 ITextViewLine 对象。

大多数双精度属性和参数对应于文本呈现坐标系中的坐标或距离。 在此坐标系中，x = 0.0 对应于 (x = 视图呈现文本的绘图图面的左边缘。ViewportLeft 对应于视区) 的左边缘，y = 视图。ViewportTop 对应于视区上边缘。 x 坐标从左到右增加，y 坐标从上到下增加。

视图的水平轴和垂直轴的行为不同。 设置视图中文本的格式时，仅设置可见行的格式。 因此，无法以相同的方式水平和垂直滚动视区。

通过更改视区左坐标来水平滚动视区，使其相对于绘图图面移动。

只能通过执行新布局来垂直滚动视图。

在视图中执行布局可能会导致视图的 ViewportTop 属性发生更改。 例如，向下滚动一行不会转换任何可见行。 相反，它只会更改视图的 ViewportTop 属性 (导致线条在屏幕上移动，即使其 y 坐标未) 更改。

文本呈现坐标系中的距离对应于逻辑像素。 如果文本呈现图面不显示任何缩放转换，则文本呈现坐标系中的 1 个单位对应于显示器上的一个像素。

属性

FirstVisibleLine	获取未完全隐藏的第一行。
FormattedSpan	获取此 ITextViewLine 集合中包含的文本范围。
IsValid	确定此 ITextViewLineCollection 对象是否仍然有效。
LastVisibleLine	获取未完全隐藏的最后一行。

方法

ContainsBufferPosition(SnapshotPoint)	确定集合中的任何对象是否包含 ITextViewLine 指定的缓冲区位置。
GetCharacterBounds(SnapshotPoint)	获取指定文本缓冲区位置的文本边界。
GetIndexOfTextLine(ITextViewLine)	获取给定文本视图行的文本行中的索引。
GetNormalizedTextBounds(SnapshotSpan)	获取与给定范围相对应的文本结构的集合 TextBounds 。
GetTextElementSpan(SnapshotPoint)	获取其文本元素范围包含给定缓冲区位置的范围。
GetTextViewLineContainingBufferPosition(SnapshotPoint)	获取 ITextViewLine 包含指定文本缓冲区位置的 。
GetTextViewLineContainingYCoordinate(Double)	获取 ITextViewLine 包含指定 y 坐标的 。
GetTextViewLinesIntersectingSpan(SnapshotSpan)	获取与 相交bufferSpan的所有 ITextViewLine 对象。
IntersectsBufferSpan(SnapshotSpan)	说明指定的缓冲区跨度是否与 ITextViewLine 集合中的任何对象相交。

扩展方法

EmptyIfNull<T>(IEnumerable<T>)

如果枚举不为 null，则返回此枚举。 如果为 null，则返回空枚举。