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	在插入號的位置已明確變更時發生。

回頁首

備註

這個介面會當做便利的方式取得目前的插入號位置，並將插入號移到不同的位置。 如需有關如何使用插入號的詳細資訊，請參閱編輯器的逐步解說中，例如逐步解說： 反白顯示文字。

大部分的屬性和參數的雙精度浮點數相對於座標或中文字呈現距離座標系統。 在此座標系統中，x = 0.0 會對應到此處呈現的文字在繪圖介面的左邊緣 (x = view.ViewportLeft相對於檢視區的左邊緣)，和 y = view.ViewportTop相對於檢視區的上邊緣。 X 座標會增加從左到右，與 y 座標會增加從上到下。 檢視表的水平及垂直軸的行為有所不同。 在檢視中的文字格式化時，只看得見的線條格式。 如此一來，檢視區無法捲動水平或垂直方式相同。 檢視區是藉由變更檢視區的左方的座標，這樣它就會移到的繪圖介面的水平捲動。 檢視表可以垂直捲動，只能藉由執行新的版面配置。 若選取的版面配置檢視中可能會導致ViewportTop的檢視中，以變更的屬性。

舉例來講，向下移一行捲動將不會轉譯任何看得見的行數。 相反地它只會變更檢視表的ViewportTop (導致移到螢幕的即使其 y 軸，以維持不變的程式碼列) 的屬性。 文字呈現的座標系統中的距離會對應到邏輯像素。 如果沒有任何縮放轉換顯示文字的呈現介面，則文字呈現的座標系統中的一個單位就相當於在顯示的一個像素。

請參閱

參考

Microsoft.VisualStudio.Text.Editor 命名空間