ITextView.DisplayTextLineContainingBufferPosition 方法 (SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)

發行項
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, _
    viewportWidthOverride As Nullable(Of Double), _
    viewportHeightOverride As Nullable(Of Double) _
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition,
    double verticalDistance,
    ViewRelativePosition relativeTo,
    Nullable<double> viewportWidthOverride,
    Nullable<double> viewportHeightOverride
)

void DisplayTextLineContainingBufferPosition(
    SnapshotPoint bufferPosition, 
    double verticalDistance, 
    ViewRelativePosition relativeTo, 
    Nullable<double> viewportWidthOverride, 
    Nullable<double> viewportHeightOverride
)

abstract DisplayTextLineContainingBufferPosition : 
        bufferPosition:SnapshotPoint * 
        verticalDistance:float * 
        relativeTo:ViewRelativePosition * 
        viewportWidthOverride:Nullable<float> * 
        viewportHeightOverride:Nullable<float> -> unit

function DisplayTextLineContainingBufferPosition(
    bufferPosition : SnapshotPoint, 
    verticalDistance : double, 
    relativeTo : ViewRelativePosition, 
    viewportWidthOverride : Nullable<double>, 
    viewportHeightOverride : Nullable<double>
)

參數

bufferPosition
類型：Microsoft.VisualStudio.Text.SnapshotPoint

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

verticalDistance
類型：Double

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

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

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

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

ViewRelativePosition。

viewportWidthOverride
類型：Nullable<Double>

如果指定此項目，在格式化文字時會視同檢視區具有指定寬度。

viewportHeightOverride
類型：Nullable<Double>

如果指定此項目，在格式化文字時會視同檢視區具有指定高度。

例外狀況

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

備註

如果文字換行功能已停用在檢視中，然後在ITextViewLine相對於整個ITextSnapshotLine包含bufferPosition。如果啟用文字換行在檢視中，然後在ITextViewLine對應到的部份ITextSnapshotLine兩者都包含bufferPosition且適合的檢視。 bufferPosition可能的第一個字元ITextViewLine。傳回的值一般是等於verticalDistance，除了其中的檢視已重新定位若要避免間距顯示在上方或下方的檢視。呼叫這個方法會處置目前的檢視TextViewLines。檢視區寬度覆寫會有任何作用，除非在檢視中啟用文字換行功能。檢視區高度和寬度會覆寫這個呼叫格式化文字的方式的變更。後續呼叫會使用的寬度和高度檢視區 (除非明確覆寫第二次)。