ITextViewLine 接口

表示已针对文本视图显示而设置了格式的文本。

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

语法

声明
Public Interface ITextViewLine

public interface ITextViewLine

public interface class ITextViewLine

type ITextViewLine =  interface end

public interface ITextViewLine

ITextViewLine 类型公开以下成员。

属性

	名称	说明
	Baseline	获取从文本顶部到行上的基线文本的距离。
	Bottom	获取行下边缘的位置（以文本呈现坐标系表示）。
	Change	获取在当前布局与前一布局之间对呈现文本行的更改。
	DefaultLineTransform	获取默认 LineTransform 用于呈现行。
	DeltaY	获取之间呈现的文本行上顶部的更改其值 Top 在当前布局和 Top 的值前一布局的。
	End	获取经过行结尾的第一个字符的位置（不包括任何换行符）。
	EndIncludingLineBreak	获取第一个字符的位置超出行尾的，包括所有换行符)。
	EndOfLineWidth	获取从行中最后一个字符的右边缘到行空间结尾的距离。
	Extent	获取行的范围（不包括任何换行符）。
	ExtentAsMappingSpan	获取与行的 Extent 相对应的 IMappingSpan。
	ExtentIncludingLineBreak	获取行的范围（包括所有换行符）。
	ExtentIncludingLineBreakAsMappingSpan	获取与 ExtentIncludingLineBreak 对应的 IMappingSpan。
	Height	获取行上边缘与下边缘之间的距离。
	IdentityTag	获取一个标记，该标记可用于跨视图中的布局跟踪 ITextViewLine 的标识。
	IsFirstTextViewLineForSnapshotLine	确定 ITextViewLine 是否为针对特定 ITextSnapshotLine 设置格式的行列表中的第一行。
	IsLastTextViewLineForSnapshotLine	确定 ITextViewLine 是否为针对特定 ITextSnapshotLine 设置格式的行列表中的最后一行。
	IsValid	确定文本视图行是否仍有效。
	Left	获取行左边缘的位置（以文本呈现坐标系表示）。
	Length	获取行的长度（不包括任何换行符）。
	LengthIncludingLineBreak	获取行的长度（包括所有换行符）。
	LineBreakLength	获取在行结尾处出现的换行符序列（例如“\r\n”）的长度。
	LineTransform	获取用于呈现行的 LineTransform。
	Right	获取行右边缘的位置（以文本呈现坐标系表示）。
	Snapshot	获取映射基于的 ITextSnapshot。
	Start	获取行中第一个字符在 Snapshot 中的位置。
	TextBottom	获取呈现的行中文本底部的 y 坐标。
	TextHeight	获取呈现的行中文本顶部与底部之间的垂直距离。
	TextLeft	获取呈现的行中文本左边缘的 x 坐标。
	TextRight	获取呈现的行中文本右边缘的 x 坐标。
	TextTop	获取呈现的行中文本顶部的 y 坐标。
	TextWidth	获取 TextRight 与 TextLeft 之间的水平距离。
	Top	获取行上边缘的位置（以文本呈现坐标系表示）。
	VirtualSpaceWidth	获取行结尾处的虚空格的宽度。
	VisibilityState	获取呈现文本行相对于视图顶部和底部的可见性状态。
	Width	获取行的左边缘与右边缘之间的距离。

页首

方法

	名称	说明
	ContainsBufferPosition	确定指定缓冲区位置是否位于文本行中。
	GetAdornmentBounds	计算指定修饰的边界。
	GetAdornmentTags	获取位于行上的修饰。
	GetBufferPositionFromXCoordinate(Double)	获取其字符边界包含给定 x 坐标的字符的缓冲区位置。
	GetBufferPositionFromXCoordinate(Double, Boolean)	获取其字符边界包含给定 x 坐标的字符的缓冲区位置。
	GetCharacterBounds(SnapshotPoint)	计算指定缓冲区位置处的字符的边界。
	GetCharacterBounds(VirtualSnapshotPoint)	计算指定缓冲区位置处的字符的边界。
	GetExtendedCharacterBounds(SnapshotPoint)	计算指定缓冲区位置处的字符的边界（包括所有空间协调修饰）。
	GetExtendedCharacterBounds(VirtualSnapshotPoint)	计算指定虚拟缓冲区位置处的字符的边界（包括所有空间协调修饰）。
	GetInsertionBufferPositionFromXCoordinate	获取在给定 x 坐标处插入新数据时使用的缓冲区位置。
	GetNormalizedTextBounds	获取与给定跨距相对应的文本的 TextBounds 结构集合。
	GetTextElementSpan	获取其文本元素索引对应于给定缓冲区位置的范围。
	GetVirtualBufferPositionFromXCoordinate	获取其字符边界包含给定 x 坐标的字符的缓冲区位置。
	IntersectsBufferSpan	确定 bufferSpan 是否与文本行相交。

页首

备注

有关格式的信息，请参见 在编辑器内“格式化文本”一节。

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

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

请参阅

参考

Microsoft.VisualStudio.Text.Formatting 命名空间