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>

參數

• point
  類型：Microsoft.VisualStudio.Text.SnapshotPoint

  IBufferGraph 中某個緩衝區內的點。

• trackingMode
  類型：Microsoft.VisualStudio.Text.PointTrackingMode

  必要時將 point 追蹤至目前快照的方式。

• match
  類型：Predicate<ITextSnapshot>

  識別目標緩衝區的述詞。

• affinity
  類型：Microsoft.VisualStudio.Text.PositionAffinity

  如果對應模稜兩可 (位置位於來源延伸接合處)，就會判斷此對應的目標應該設為緊鄰上方緩衝區中前置字元後面的位置，還是緊鄰上方緩衝區中後續字元前面的位置。

  如果對應並非模稜兩可，這個設定就沒有作用。

傳回值

類型：Nullable<SnapshotPoint>
相符的緩衝區，快照中的對應位置或nullnull 參考 (即 Visual Basic 中的 Nothing)如果沒有對應至相符的緩衝區。

例外狀況

例外狀況	條件
ArgumentNullException	point.Snapshot or match is nullnull 參考 (即 Visual Basic 中的 Nothing).
ArgumentOutOfRangeException	trackingModeis not a valid PointTrackingMode, or affinity is not a valid PositionAffinity.

備註

match直到它傳回緩衝區圖形中的每個文字緩衝區上呼叫true。 述詞不會呼叫一次。

.NET Framework 安全性

• 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。

請參閱

參考

IBufferGraph 介面

MapUpToFirstMatch 多載

Microsoft.VisualStudio.Text.Projection 命名空間