IBufferGraph::MapDownToFirstMatch Method (SnapshotSpan, SpanTrackingMode, Predicate<ITextSnapshot^>^)

Visual Studio 2015

Maps a snapshot span in some buffer in the graph to a sequence of zero or more spans in some source snapshot selected by a predicate.

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

Syntax

NormalizedSnapshotSpanCollection^ MapDownToFirstMatch(
	SnapshotSpan span,
	SpanTrackingMode trackingMode,
	Predicate<ITextSnapshot^>^ match
)

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.

match: Type: System::Predicate<ITextSnapshot^>^
The predicate that identifies the target buffer.

A collection of zero or more snapshot spans in the target buffer to which the topSpan maps.

Exception	Condition
ArgumentNullException	span.Snapshot or match is null.
ArgumentOutOfRangeException	trackingMode is not a valid SpanTrackingMode.

match is called on each text buffer in the buffer graph until it returns true. The predicate will not be called again.