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	判斷在針對特定 ITextSnapshotLine 格式化之行的清單中，此 ITextViewLine 是否為第一行。
	IsLastTextViewLineForSnapshotLine	判斷在針對特定 ITextSnapshotLine 格式化之行的清單中，此 ITextViewLine 是否為最後一行。
	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 是否與此文字行有交集。

回頁首

備註

格式設定的相關資訊，請參閱 「 格式化的文字 」 區段中的在 [編輯器]。

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

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

請參閱

參考

Microsoft.VisualStudio.Text.Formatting 命名空間