ITextCaret 接口

表示与 ITextView 相关联的插入符号。

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

语法

声明
Public Interface ITextCaret

public interface ITextCaret

public interface class ITextCaret

type ITextCaret =  interface end

public interface ITextCaret

ITextCaret 类型公开以下成员。

属性

	名称	说明
	Bottom	获取插入符号下边缘的位置（以文本呈现坐标系表示）。
	ContainingTextViewLine	获取包含插入符号的 ITextViewLine，前提是该文本行在视图中可见。
	Height	获取插入符号的高度（以文本呈现坐标系表示）。
	InVirtualSpace	确定插入符号是否位于虚空格中。虚空格位于实际行尾的后面。
	IsHidden	获取或设置插入符号的可见性。
	Left	获取插入符号左边缘的位置（以文本呈现坐标系表示）。
	OverwriteMode	确定插入符号是否处于覆盖模式。
	Position	获取插入符号的当前位置。
	Right	获取插入符号右边缘的位置（以文本呈现坐标系表示）。
	Top	获取插入符号上边缘的位置（以文本呈现坐标系表示）。
	Width	获取插入符号的宽度（以文本呈现坐标系表示）。

页首

方法

	名称	说明
	EnsureVisible	通过上下左右滚动视图直到显示插入符号，从而使插入符号可见。
	MoveTo(ITextViewLine)	将插入符号移至指定的文本行，同时保留其当前 x 坐标。
	MoveTo(SnapshotPoint)	将插入符号移至基础 ITextBuffer 中的给定索引。
	MoveTo(VirtualSnapshotPoint)	将脱字号移至指定缓冲区位置。
	MoveTo(ITextViewLine, Double)	将插入符号移至指定 x 坐标和文本行的最佳 CaretPosition。
	MoveTo(SnapshotPoint, PositionAffinity)	将插入符号移至基础 ITextBuffer 中的给定索引。
	MoveTo(VirtualSnapshotPoint, PositionAffinity)	将脱字号移至指定缓冲区位置。
	MoveTo(ITextViewLine, Double, Boolean)	将插入符号移至指定 x 坐标和文本行的最佳 CaretPosition。
	MoveTo(SnapshotPoint, PositionAffinity, Boolean)	将插入符号移至基础 ITextBuffer 中的给定索引。
	MoveTo(VirtualSnapshotPoint, PositionAffinity, Boolean)	将脱字号移至指定缓冲区位置。
	MoveToNextCaretPosition	将插入符号移至下一个有效的 CaretPosition。
	MoveToPreferredCoordinates	将脱字号移至首选的 x 坐标和 y 坐标。
	MoveToPreviousCaretPosition	将插入符号移至上一个有效的 CaretPosition。

页首

事件

	名称	说明
	PositionChanged	在插入符号的位置已显式更改时发生。

页首

备注

此接口作为一种方便方式获取插入符号的当前位置服务和移动脱字号移至不同的位置。 有关使用插入符号的更多信息，请参见编辑演练，例如 演练:显示文本。

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

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

请参阅

参考

Microsoft.VisualStudio.Text.Editor 命名空间