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.