IBufferGraph.MapDownToFirstMatch 方法 (SnapshotPoint, PointTrackingMode, Predicate<ITextSnapshot>, PositionAffinity)
將圖形中的位置對應至圖形中較低相符緩衝區中的位置。 來源緩衝區會被視為低於取用它們的投影緩衝區。
命名空間： Microsoft.VisualStudio.Text.Projection
組件： Microsoft.VisualStudio.Text.Data (在 Microsoft.VisualStudio.Text.Data.dll 中)
語法
'宣告
Function MapDownToFirstMatch ( _
position As SnapshotPoint, _
trackingMode As PointTrackingMode, _
match As Predicate(Of ITextSnapshot), _
affinity As PositionAffinity _
) As Nullable(Of SnapshotPoint)
Nullable<SnapshotPoint> MapDownToFirstMatch(
SnapshotPoint position,
PointTrackingMode trackingMode,
Predicate<ITextSnapshot> match,
PositionAffinity affinity
)
Nullable<SnapshotPoint> MapDownToFirstMatch(
SnapshotPoint position,
PointTrackingMode trackingMode,
Predicate<ITextSnapshot^>^ match,
PositionAffinity affinity
)
abstract MapDownToFirstMatch :
position:SnapshotPoint *
trackingMode:PointTrackingMode *
match:Predicate<ITextSnapshot> *
affinity:PositionAffinity -> Nullable<SnapshotPoint>
function MapDownToFirstMatch(
position : SnapshotPoint,
trackingMode : PointTrackingMode,
match : Predicate<ITextSnapshot>,
affinity : PositionAffinity
) : Nullable<SnapshotPoint>
參數
position
類型：Microsoft.VisualStudio.Text.SnapshotPoint圖形中緩衝區內的位置。
trackingMode
類型：Microsoft.VisualStudio.Text.PointTrackingMode必要時將 position 追蹤至目前快照的方式。
match
類型：Predicate<ITextSnapshot>識別目標緩衝區的述詞。
affinity
類型：Microsoft.VisualStudio.Text.PositionAffinity如果對應模稜兩可 (位置位於來源延伸接合處)，就會判斷此對應的目標應該設為緊鄰上方緩衝區中前置字元後面的位置，還是緊鄰上方緩衝區中後續字元前面的位置。
如果對應並非模稜兩可，這個設定就沒有作用。
傳回值
類型：Nullable<SnapshotPoint>
快照集的目標緩衝區中，某個位置或nullnull 參考 (即 Visual Basic 中的 Nothing)如果位置未對應到所選取的任何緩衝區match。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | position.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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。