Freigeben über


ITextView.DisplayTextLineContainingBufferPosition-Methode (SnapshotPoint, Double, ViewRelativePosition)

Formatiert den Inhalt des Textpuffers und zeigt ihn an, damit ITextViewLine , das die Pufferposition enthält, in der gewünschten Position angezeigt wird.

Namespace:  Microsoft.VisualStudio.Text.Editor
Assembly:  Microsoft.VisualStudio.Text.UI (in Microsoft.VisualStudio.Text.UI.dll)

Syntax

'Declaration
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
)

Parameter

  • verticalDistance
    Typ: Double

    Der Abstand (in Pixeln) zwischen der ITextViewLine und dem Rand der Ansicht. Wenn relativeTo und ViewRelativePosition.Top gleich sind, liegt der Abstand zwischen dem oberen Rand der Ansicht und dem oberen Rand der ITextViewLine. Andernfalls handelt es sich um die Entfernung zwischen dem unteren Rand der ITextViewLine und dem unteren Rand der Ansicht.

    Negative Werte sind zulässig, die möglicherweise dazu führen, dass die Zeile außerhalb des Viewports angezeigt zu werden.

    Diese Methode kann relativ aufwendig werden, wenn verticalDistance groß ist. Sie sollten vermeiden, dass verticalDistance größer als die Höhe der Ansicht ist.

Ausnahmen

Ausnahme Bedingung
ArgumentException

bufferPosition ist der falschen ITextSnapshot oder ITextBuffer.

ArgumentOutOfRangeException

relativeTo ist kein gültiger ViewRelativePosition.

Hinweise

Wenn der Zeilenumbruch in der Ansicht deaktiviert ist, dann entspricht ITextViewLine auf der gesamten ITextSnapshotLine , die bufferPositionenthält. Wenn der Zeilenumbruch in der Ansicht aktiviert ist, dann entspricht ITextViewLine einen Teil ITextSnapshotLine , dem beide bufferPosition und Anpassungen in die Ansicht enthält. bufferPosition ist möglicherweise nicht das erste Zeichen in ITextViewLine. Der zurückgegebene Wert ist im Allgemeinen gleich verticalDistance, als sei denn, die Sicht neu angeordnet wurde, um eine Lücke an oben angezeigt werden oder unteren Rand der Ansicht zu verhindern. Das Aufrufen dieser Methode bewirkt, dass die Ansicht des aktuellen TextViewLinesfreizugeben.

.NET Framework-Sicherheit

Siehe auch

Referenz

ITextView Schnittstelle

DisplayTextLineContainingBufferPosition-Überladung

Microsoft.VisualStudio.Text.Editor-Namespace