ITextView.DisplayTextLineContainingBufferPosition-Methode (SnapshotPoint, Double, ViewRelativePosition, Nullable<Double>, Nullable<Double>)

Artikel
05/16/2015

Formatiert den Inhalt des Textpuffers und zeigt ihn an, damit ITextViewLine , das die angegebene 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, _
    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>
)

Parameter

bufferPosition
Typ: Microsoft.VisualStudio.Text.SnapshotPoint

Die Position des Zeichens, das in der an der angegebenen vertikalen Position angezeigten ITextViewLine enthalten sein soll.

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.

relativeTo
Typ: Microsoft.VisualStudio.Text.Editor.ViewRelativePosition

ViewRelativePosition.

viewportWidthOverride
Typ: Nullable<Double>

Wenn dies angegeben wird, wird der Text so formatiert, als ob der Viewport über die angegebene Breite verfügen würde.

viewportHeightOverride
Typ: Nullable<Double>

Wenn dies angegeben wird, wird der Text so formatiert, als ob der Viewport über die angegebene Höhe verfügen würde.

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, wenn 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. Mit breiten Viewport Überschreibung hat keine Auswirkungen, es sei denn, Zeilenumbruch in der Ansicht aktiviert ist. Die Viewport höhen- und - breite nur ändern überschreibungen für diesen Aufruf, wie Text formatiert wird. Nachfolgende Aufrufe verwenden die Breite und Höhe des Viewports (es sei denn, ein zweites Mal explizit außer Kraft gesetzt).

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

ITextView Schnittstelle

DisplayTextLineContainingBufferPosition-Überladung

Microsoft.VisualStudio.Text.Editor-Namespace

Freigeben über