IProjectionBuffer::InsertSpan Method (Int32, ITrackingSpan^)

Visual Studio 2015

Inserts a tracking span into the list of source spans.

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

Syntax

IProjectionSnapshot^ InsertSpan(
	int position,
	ITrackingSpan^ spanToInsert
)

position: Type: System::Int32
The position at which to insert spanToInsert.

spanToInsert: Type: Microsoft.VisualStudio.Text::ITrackingSpan^
The span to insert.

Exception	Condition
ArgumentNullException	spanToInsert is null.
ArgumentOutOfRangeException	position is less than zero or greater than the number of spans.
ArgumentException	spanToInsert would cause a duplicated projection, or spanToInsert is EdgeInclusive and does not cover its entire buffer, or is EdgePositive and does not abut the end of its buffer, or is EdgeNegative and does not abut the beginning of its buffer. (These checks are not performed if the projection buffer was created with the PermissiveEdgeInclusiveSourceSpans option.) Or: adding the text buffer containing spanToInsert would create a cycle among a set of projection buffers.