IBufferGraph.MapDownToFirstMatch Method (SnapshotSpan, SpanTrackingMode, Predicate<ITextSnapshot>)
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
'Declaration
Function MapDownToFirstMatch ( _
span As SnapshotSpan, _
trackingMode As SpanTrackingMode, _
match As Predicate(Of ITextSnapshot) _
) As NormalizedSnapshotSpanCollection
NormalizedSnapshotSpanCollection MapDownToFirstMatch(
SnapshotSpan span,
SpanTrackingMode trackingMode,
Predicate<ITextSnapshot> match
)
NormalizedSnapshotSpanCollection^ MapDownToFirstMatch(
SnapshotSpan span,
SpanTrackingMode trackingMode,
Predicate<ITextSnapshot^>^ match
)
abstract MapDownToFirstMatch :
span:SnapshotSpan *
trackingMode:SpanTrackingMode *
match:Predicate<ITextSnapshot> -> NormalizedSnapshotSpanCollection
function MapDownToFirstMatch(
span : SnapshotSpan,
trackingMode : SpanTrackingMode,
match : Predicate<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.
- match
Type: System.Predicate<ITextSnapshot>
The predicate that identifies the target buffer.
Return Value
Type: Microsoft.VisualStudio.Text.NormalizedSnapshotSpanCollection
A collection of zero or more snapshot spans in the target buffer to which the topSpan maps.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | span.Snapshot or match is nulla null reference (Nothing in Visual Basic). |
| ArgumentOutOfRangeException | trackingMode is not a valid SpanTrackingMode. |
Remarks
match is called on each text buffer in the buffer graph until it returns true. The predicate will not be called again.
.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.