将关系图中的位置映射到关系图中处于较低层的缓冲区内的对应位置。 源缓冲区被视为低于使用它们的投影缓冲区。
命名空间: Microsoft.VisualStudio.Text.Projection
程序集: Microsoft.VisualStudio.Text.Data(在 Microsoft.VisualStudio.Text.Data.dll 中)
语法
声明
Function MapDownToBuffer ( _
position As SnapshotPoint, _
trackingMode As PointTrackingMode, _
targetBuffer As ITextBuffer, _
affinity As PositionAffinity _
) As Nullable(Of SnapshotPoint)
Nullable<SnapshotPoint> MapDownToBuffer(
SnapshotPoint position,
PointTrackingMode trackingMode,
ITextBuffer targetBuffer,
PositionAffinity affinity
)
Nullable<SnapshotPoint> MapDownToBuffer(
SnapshotPoint position,
PointTrackingMode trackingMode,
ITextBuffer^ targetBuffer,
PositionAffinity affinity
)
abstract MapDownToBuffer :
position:SnapshotPoint *
trackingMode:PointTrackingMode *
targetBuffer:ITextBuffer *
affinity:PositionAffinity -> Nullable<SnapshotPoint>
function MapDownToBuffer(
position : SnapshotPoint,
trackingMode : PointTrackingMode,
targetBuffer : ITextBuffer,
affinity : PositionAffinity
) : Nullable<SnapshotPoint>
参数
position
类型:Microsoft.VisualStudio.Text.SnapshotPoint关系图中的缓冲区内的位置。
trackingMode
类型:Microsoft.VisualStudio.Text.PointTrackingMode如何跟踪 position 直到当前快照(如果需要)。
targetBuffer
类型:Microsoft.VisualStudio.Text.ITextBufferposition 要映射到的缓冲区。
affinity
类型:Microsoft.VisualStudio.Text.PositionAffinity如果映射不明确(位置位于源范围接合处),则确定映射目标应紧跟在顶层缓冲区中前一个字符之后还是应紧跟在后一个字符之前。
如果映射明确,则此设置不起作用。
返回值
类型:Nullable<SnapshotPoint>
在目标缓冲区快照中的一个点或 nullnull 引用(在 Visual Basic 中为 Nothing) ,如果顶部的位置未映射到具有给定关联的此缓冲区。
异常
异常 | 条件 |
---|---|
ArgumentNullException | position。快照或 targetBuffer 是 nullnull 引用(在 Visual Basic 中为 Nothing)。 |
ArgumentOutOfRangeException | trackingMode 不是有效的 PointTrackingMode,或者 affinity 不是有效的 PositionAffinity。 |
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。