IBufferGraph.MapUpToFirstMatch 方法 (SnapshotPoint, PointTrackingMode, Predicate<ITextSnapshot>, PositionAffinity)

将作为缓冲区关系图成员的某一缓冲区的当前快照中的位置映射到谓词所选择的某一缓冲区的快照。

命名空间:  Microsoft.VisualStudio.Text.Projection
程序集:  Microsoft.VisualStudio.Text.Data(在 Microsoft.VisualStudio.Text.Data.dll 中)

语法

声明
Function MapUpToFirstMatch ( _
    point As SnapshotPoint, _
    trackingMode As PointTrackingMode, _
    match As Predicate(Of ITextSnapshot), _
    affinity As PositionAffinity _
) As Nullable(Of SnapshotPoint)
Nullable<SnapshotPoint> MapUpToFirstMatch(
    SnapshotPoint point,
    PointTrackingMode trackingMode,
    Predicate<ITextSnapshot> match,
    PositionAffinity affinity
)
Nullable<SnapshotPoint> MapUpToFirstMatch(
    SnapshotPoint point, 
    PointTrackingMode trackingMode, 
    Predicate<ITextSnapshot^>^ match, 
    PositionAffinity affinity
)
abstract MapUpToFirstMatch : 
        point:SnapshotPoint * 
        trackingMode:PointTrackingMode * 
        match:Predicate<ITextSnapshot> * 
        affinity:PositionAffinity -> Nullable<SnapshotPoint> 
function MapUpToFirstMatch(
    point : SnapshotPoint, 
    trackingMode : PointTrackingMode, 
    match : Predicate<ITextSnapshot>, 
    affinity : PositionAffinity
) : Nullable<SnapshotPoint>

参数

  • match
    类型:Predicate<ITextSnapshot>

    标识目标缓冲区的谓词。

  • affinity
    类型:Microsoft.VisualStudio.Text.PositionAffinity

    如果映射不明确(位置位于源范围接合处),则确定映射目标应紧跟在顶层缓冲区中前一个字符之后还是应紧跟在后一个字符之前。

    如果映射明确,则此设置不起作用。

返回值

类型:Nullable<SnapshotPoint>
匹配缓冲区的快照中的对应位置或 nullnull 引用(在 Visual Basic 中为 Nothing) ,如果未映射到匹配缓冲区。

异常

异常 条件
ArgumentNullException

point。快照或 match 是 nullnull 引用(在 Visual Basic 中为 Nothing)。

ArgumentOutOfRangeException

trackingMode 不是有效的 PointTrackingMode,或者 affinity 不是有效的 PositionAffinity

备注

match 为缓冲区关系图中的每个文本缓冲区称为,直到返回 true。 谓词将不再调用。

.NET Framework 安全性

请参阅

参考

IBufferGraph 接口

MapUpToFirstMatch 重载

Microsoft.VisualStudio.Text.Projection 命名空间