ITextViewLineCollection 介面

定義

命名空間:

Microsoft.VisualStudio.Text.Editor

組件:

Microsoft.VisualStudio.Text.UI.dll

套件:

Microsoft.VisualStudio.Text.UI v17.11.260

表示用來存取檢視物件集合的 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，則傳回空列舉。