格式化和显示文本缓冲区的内容,以便包含指定缓冲区位置的 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
类型:DoubleITextViewLine 与视图边缘之间的距离(以像素为单位)。 如果 relativeTo 等于 ViewRelativePosition.Top,则为视图顶部到 ITextViewLine 顶部的距离。 否则,为 ITextViewLine 底部到视图底部的距离。
允许负值,可导致行在视区之外显示。
如果 verticalDistance 过大,则此方法的开销可能会很高。 应避免 verticalDistance 超过视图高度。
viewportWidthOverride
类型:Nullable<Double>如果指定,则按视区具有指定宽度的要求设置文本格式。
viewportHeightOverride
类型:Nullable<Double>如果指定,则按视区具有指定高度的要求设置文本格式。
异常
异常 | 条件 |
---|---|
ArgumentException | bufferPosition 是从错误的 ITextSnapshot 或 ITextBuffer。 |
ArgumentOutOfRangeException | relativeTo 不是有效的 ViewRelativePosition。 |
备注
如果自动换行在包含 bufferPosition的视图禁用,则 ITextViewLine 对应于整个 ITextSnapshotLine 。 自动换行在视图中启用,则 ITextViewLine 对应于包含 bufferPosition 并放入视图 ITextSnapshotLine 的一部分。 bufferPosition 可能不是在 ITextViewLine的第一个字符。 该返回的值与视图重新定位防止空白将出现在视图的顶部或底部的 verticalDistance通常相等,但。 调用此方法会导致视图处理其当前 TextViewLines。 ,除非自动换行在视图中,启用视区宽度重写将不起作用。 视区高度和宽度只重写方式更改用于此格式调用。 对的后续调用将使用视区的宽度和高度 (除非显式重写第二次)。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。