ITextView.DisplayTextLineContainingBufferPosition 方法 (SnapshotPoint, Double, ViewRelativePosition)

發行項
05/16/2015

將格式設定，並顯示文字緩衝區的內容，讓ITextViewLine包含緩衝區位置會顯示在想要的位置。

命名空間： Microsoft.VisualStudio.Text.Editor
組件： Microsoft.VisualStudio.Text.UI (在 Microsoft.VisualStudio.Text.UI.dll 中)

語法

'宣告
Sub DisplayTextLineContainingBufferPosition ( _
    bufferPosition As SnapshotPoint, _
    verticalDistance As Double, _
    relativeTo As ViewRelativePosition _
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition,
    double verticalDistance,
    ViewRelativePosition relativeTo
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition, 
    double verticalDistance, 
    ViewRelativePosition relativeTo
)

abstract DisplayTextLineContainingBufferPosition : 
        bufferPosition:SnapshotPoint * 
        verticalDistance:float * 
        relativeTo:ViewRelativePosition -> unit

function DisplayTextLineContainingBufferPosition(
    bufferPosition : SnapshotPoint, 
    verticalDistance : double, 
    relativeTo : ViewRelativePosition
)

參數

bufferPosition
類型：Microsoft.VisualStudio.Text.SnapshotPoint

要包含在 ITextViewLine 中的字元顯示於指定垂直位置上的位置。

verticalDistance
類型：Double

ITextViewLine 與檢視邊緣之間的距離 (以像素為單位)。如果 relativeTo 等於 ViewRelativePosition.Top，則距離為檢視頂端至 ITextViewLine 頂端。否則，這將是 ITextViewLine 底部與檢視底部之間的距離。

可以指定負值，而造成行来顯示超出檢視區。

如果 verticalDistance 很大，此方法可能會耗用很多資源。您應避免讓 verticalDistance 超出檢視的高度。

relativeTo
類型：Microsoft.VisualStudio.Text.Editor.ViewRelativePosition

ViewRelativePosition。

例外狀況

例外狀況	條件
ArgumentException	bufferPosition來自錯誤ITextSnapshot或ITextBuffer。
ArgumentOutOfRangeException	relativeTo 不是有效的 ViewRelativePosition。

備註

如果文字換行功能已停用在檢視中，然後在ITextViewLine相對於整個ITextSnapshotLine包含bufferPosition。如果啟用文字換行在檢視中，然後在ITextViewLine對應到的部份ITextSnapshotLine兩者都包含bufferPosition且適合的檢視。 bufferPosition可能的第一個字元ITextViewLine。傳回的值一般是等於verticalDistance，但當檢視已重新定位若要避免間距顯示在上方或下方的檢視。呼叫這個方法會處置目前的檢視TextViewLines。