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

格式化和显示文本缓冲区的内容,以便包含指定缓冲区位置的 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>
)

参数

  • verticalDistance
    类型:Double

    ITextViewLine 与视图边缘之间的距离(以像素为单位)。 如果 relativeTo 等于 ViewRelativePosition.Top,则为视图顶部到 ITextViewLine 顶部的距离。 否则,为 ITextViewLine 底部到视图底部的距离。

    允许负值,可导致行在视区之外显示。

    如果 verticalDistance 过大,则此方法的开销可能会很高。 应避免 verticalDistance 超过视图高度。

  • viewportWidthOverride
    类型:Nullable<Double>

    如果指定,则按视区具有指定宽度的要求设置文本格式。

  • viewportHeightOverride
    类型:Nullable<Double>

    如果指定,则按视区具有指定高度的要求设置文本格式。

异常

异常 条件
ArgumentException

bufferPosition 是从错误的 ITextSnapshotITextBuffer

ArgumentOutOfRangeException

relativeTo 不是有效的 ViewRelativePosition

备注

如果自动换行在包含 bufferPosition的视图禁用,则 ITextViewLine 对应于整个 ITextSnapshotLine 。 自动换行在视图中启用,则 ITextViewLine 对应于包含 bufferPosition 并放入视图 ITextSnapshotLine 的一部分。 bufferPosition 可能不是在 ITextViewLine的第一个字符。 该返回的值与视图重新定位防止空白将出现在视图的顶部或底部的 verticalDistance通常相等,但。 调用此方法会导致视图处理其当前 TextViewLines。 ,除非自动换行在视图中,启用视区宽度重写将不起作用。 视区高度和宽度只重写方式更改用于此格式调用。 对的后续调用将使用视区的宽度和高度 (除非显式重写第二次)。

.NET Framework 安全性

请参阅

参考

ITextView 接口

DisplayTextLineContainingBufferPosition 重载

Microsoft.VisualStudio.Text.Editor 命名空间