IBufferGraph.MapUpToSnapshot 方法 (SnapshotPoint, PointTrackingMode, PositionAffinity, ITextSnapshot)

發行項
05/16/2015

將緩衝區 (屬於緩衝區圖形的成員) 之目前快照中的位置對應至指定的快照。

命名空間： Microsoft.VisualStudio.Text.Projection
組件： Microsoft.VisualStudio.Text.Data (在 Microsoft.VisualStudio.Text.Data.dll 中)

語法

'宣告
Function MapUpToSnapshot ( _
    point As SnapshotPoint, _
    trackingMode As PointTrackingMode, _
    affinity As PositionAffinity, _
    targetSnapshot As ITextSnapshot _
) As Nullable(Of SnapshotPoint)

Nullable<SnapshotPoint> MapUpToSnapshot(
    SnapshotPoint point,
    PointTrackingMode trackingMode,
    PositionAffinity affinity,
    ITextSnapshot targetSnapshot
)

Nullable<SnapshotPoint> MapUpToSnapshot(
    SnapshotPoint point, 
    PointTrackingMode trackingMode, 
    PositionAffinity affinity, 
    ITextSnapshot^ targetSnapshot
)

abstract MapUpToSnapshot : 
        point:SnapshotPoint * 
        trackingMode:PointTrackingMode * 
        affinity:PositionAffinity * 
        targetSnapshot:ITextSnapshot -> Nullable<SnapshotPoint>

function MapUpToSnapshot(
    point : SnapshotPoint, 
    trackingMode : PointTrackingMode, 
    affinity : PositionAffinity, 
    targetSnapshot : ITextSnapshot
) : Nullable<SnapshotPoint>

參數

point
類型：Microsoft.VisualStudio.Text.SnapshotPoint

IBufferGraph 中某個緩衝區內的點。

trackingMode
類型：Microsoft.VisualStudio.Text.PointTrackingMode

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

affinity
類型：Microsoft.VisualStudio.Text.PositionAffinity

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

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

targetSnapshot
類型：Microsoft.VisualStudio.Text.ITextSnapshot

要對應的快照。

傳回值

類型：Nullable<SnapshotPoint>
在對應位置targetSnapshot，或nullnull 參考 (即 Visual Basic 中的 Nothing)如果位置不會對應至targetSnapshot使用這個圖表。

例外狀況

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