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
bufferPosition
Typ: Microsoft.VisualStudio.Text.SnapshotPointDie Position des Zeichens, das in der an der angegebenen vertikalen Position angezeigten ITextViewLine enthalten sein soll.
verticalDistance
Typ: DoubleDer 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
- 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.