IBufferGraph.MapDownToSnapshot Method (SnapshotSpan, SpanTrackingMode, ITextSnapshot)

Maps a snapshot span in some buffer in the graph to a sequence of zero or more spans in a buffer that is lower in the graph. Source buffers are considered to be lower than the projection buffers that consume them.

Namespace:  Microsoft.VisualStudio.Text.Projection
Assembly:  Microsoft.VisualStudio.Text.Data (in Microsoft.VisualStudio.Text.Data.dll)

Syntax

'Declaration
Function MapDownToSnapshot ( _
    span As SnapshotSpan, _
    trackingMode As SpanTrackingMode, _
    targetSnapshot As ITextSnapshot _
) As NormalizedSnapshotSpanCollection

NormalizedSnapshotSpanCollection MapDownToSnapshot(
    SnapshotSpan span,
    SpanTrackingMode trackingMode,
    ITextSnapshot targetSnapshot
)

NormalizedSnapshotSpanCollection^ MapDownToSnapshot(
    SnapshotSpan span, 
    SpanTrackingMode trackingMode, 
    ITextSnapshot^ targetSnapshot
)

abstract MapDownToSnapshot : 
        span:SnapshotSpan * 
        trackingMode:SpanTrackingMode * 
        targetSnapshot:ITextSnapshot -> NormalizedSnapshotSpanCollection

function MapDownToSnapshot(
    span : SnapshotSpan, 
    trackingMode : SpanTrackingMode, 
    targetSnapshot : ITextSnapshot
) : NormalizedSnapshotSpanCollection

Parameters

• span
  Type: Microsoft.VisualStudio.Text.SnapshotSpan

  The span that is to be mapped.

• trackingMode
  Type: Microsoft.VisualStudio.Text.SpanTrackingMode

  How span is tracked to the current snapshot if necessary.

• targetSnapshot
  Type: Microsoft.VisualStudio.Text.ITextSnapshot

  The buffer to which to map the span.

Return Value

Type: Microsoft.VisualStudio.Text.NormalizedSnapshotSpanCollection
A collection of zero or more snapshot spans in the target buffer to which the span maps.

Exceptions

Exception	Condition
ArgumentNullException	span.Snapshot or targetSnapshot is nulla null reference (Nothing in Visual Basic).
ArgumentOutOfRangeException	trackingMode is not a valid SpanTrackingMode.

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

IBufferGraph Interface

MapDownToSnapshot Overload

Microsoft.VisualStudio.Text.Projection Namespace