IBufferGraph.MapUpToBuffer 方法 (SnapshotPoint, PointTrackingMode, PositionAffinity, ITextBuffer)

發行項
05/16/2015

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

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

語法

'宣告
Function MapUpToBuffer ( _
    point As SnapshotPoint, _
    trackingMode As PointTrackingMode, _
    affinity As PositionAffinity, _
    targetBuffer As ITextBuffer _
) As Nullable(Of SnapshotPoint)

Nullable<SnapshotPoint> MapUpToBuffer(
    SnapshotPoint point,
    PointTrackingMode trackingMode,
    PositionAffinity affinity,
    ITextBuffer targetBuffer
)

Nullable<SnapshotPoint> MapUpToBuffer(
    SnapshotPoint point, 
    PointTrackingMode trackingMode, 
    PositionAffinity affinity, 
    ITextBuffer^ targetBuffer
)

abstract MapUpToBuffer : 
        point:SnapshotPoint * 
        trackingMode:PointTrackingMode * 
        affinity:PositionAffinity * 
        targetBuffer:ITextBuffer -> Nullable<SnapshotPoint>

function MapUpToBuffer(
    point : SnapshotPoint, 
    trackingMode : PointTrackingMode, 
    affinity : PositionAffinity, 
    targetBuffer : ITextBuffer
) : Nullable<SnapshotPoint>

參數

point
類型：Microsoft.VisualStudio.Text.SnapshotPoint

IBufferGraph 中某個緩衝區內的點。

trackingMode
類型：Microsoft.VisualStudio.Text.PointTrackingMode

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

affinity
類型：Microsoft.VisualStudio.Text.PositionAffinity

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

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

targetBuffer
類型：Microsoft.VisualStudio.Text.ITextBuffer

要對應的緩衝區。

傳回值

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

例外狀況

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