IPersistentSpanFactory.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
Create(SnapshotSpan, SpanTrackingMode) |
Create an IPersistentSpan for a snapshot span on a document that is currently open. |
Create(String, Span, SpanTrackingMode) |
Create an IPersistentSpan for a snapshot span on a document that is currently closed. |
Create(ITextSnapshot, Int32, Int32, Int32, Int32, SpanTrackingMode) |
Create an IPersistentSpan for a snapshot span on a document that is currently open. |
Create(String, Int32, Int32, Int32, Int32, SpanTrackingMode) |
Create an IPersistentSpan for a snapshot span on a document that is currently closed. |
Create(SnapshotSpan, SpanTrackingMode)
Create an IPersistentSpan for a snapshot span on a document that is currently open.
public:
Microsoft::VisualStudio::Text::IPersistentSpan ^ Create(Microsoft::VisualStudio::Text::SnapshotSpan span, Microsoft::VisualStudio::Text::SpanTrackingMode trackingMode);
public Microsoft.VisualStudio.Text.IPersistentSpan Create (Microsoft.VisualStudio.Text.SnapshotSpan span, Microsoft.VisualStudio.Text.SpanTrackingMode trackingMode);
abstract member Create : Microsoft.VisualStudio.Text.SnapshotSpan * Microsoft.VisualStudio.Text.SpanTrackingMode -> Microsoft.VisualStudio.Text.IPersistentSpan
Public Function Create (span As SnapshotSpan, trackingMode As SpanTrackingMode) As IPersistentSpan
Parameters
- span
- SnapshotSpan
The span of text in this snapshot.
- trackingMode
- SpanTrackingMode
How the tracking span will react to changes at its boundaries.
Returns
The newly created span or null if one can not be created.
Applies to
Create(String, Span, SpanTrackingMode)
Create an IPersistentSpan for a snapshot span on a document that is currently closed.
public:
Microsoft::VisualStudio::Text::IPersistentSpan ^ Create(System::String ^ filePath, Microsoft::VisualStudio::Text::Span span, Microsoft::VisualStudio::Text::SpanTrackingMode trackingMode);
public Microsoft.VisualStudio.Text.IPersistentSpan Create (string filePath, Microsoft.VisualStudio.Text.Span span, Microsoft.VisualStudio.Text.SpanTrackingMode trackingMode);
abstract member Create : string * Microsoft.VisualStudio.Text.Span * Microsoft.VisualStudio.Text.SpanTrackingMode -> Microsoft.VisualStudio.Text.IPersistentSpan
Public Function Create (filePath As String, span As Span, trackingMode As SpanTrackingMode) As IPersistentSpan
Parameters
- filePath
- String
Name of the file that contains the span.
- span
- Span
Span as character offsets from the start of the file.
- trackingMode
- SpanTrackingMode
How the tracking span will react to changes at its boundaries.
Returns
The newly created span.
Remarks
Using this method to create an IPersistentSpan on a document that is already open is an error (and will prevent the span from tracking properly).
Applies to
Create(ITextSnapshot, Int32, Int32, Int32, Int32, SpanTrackingMode)
Create an IPersistentSpan for a snapshot span on a document that is currently open.
public:
Microsoft::VisualStudio::Text::IPersistentSpan ^ Create(Microsoft::VisualStudio::Text::ITextSnapshot ^ snapshot, int startLine, int startIndex, int endLine, int endIndex, Microsoft::VisualStudio::Text::SpanTrackingMode trackingMode);
public Microsoft.VisualStudio.Text.IPersistentSpan Create (Microsoft.VisualStudio.Text.ITextSnapshot snapshot, int startLine, int startIndex, int endLine, int endIndex, Microsoft.VisualStudio.Text.SpanTrackingMode trackingMode);
abstract member Create : Microsoft.VisualStudio.Text.ITextSnapshot * int * int * int * int * Microsoft.VisualStudio.Text.SpanTrackingMode -> Microsoft.VisualStudio.Text.IPersistentSpan
Public Function Create (snapshot As ITextSnapshot, startLine As Integer, startIndex As Integer, endLine As Integer, endIndex As Integer, trackingMode As SpanTrackingMode) As IPersistentSpan
Parameters
- snapshot
- ITextSnapshot
The snapshot of the currently open document to create the span on.
- startLine
- Int32
Line number of the start point.
- startIndex
- Int32
Character offset from the start of the line containing the start point.
- endLine
- Int32
Line number of the end point.
- endIndex
- Int32
Character offset from the start of the line containing the end point.
- trackingMode
- SpanTrackingMode
How the tracking span will react to changes at its boundaries.
Returns
The newly created span.
Applies to
Create(String, Int32, Int32, Int32, Int32, SpanTrackingMode)
Create an IPersistentSpan for a snapshot span on a document that is currently closed.
public:
Microsoft::VisualStudio::Text::IPersistentSpan ^ Create(System::String ^ filePath, int startLine, int startIndex, int endLine, int endIndex, Microsoft::VisualStudio::Text::SpanTrackingMode trackingMode);
public Microsoft.VisualStudio.Text.IPersistentSpan Create (string filePath, int startLine, int startIndex, int endLine, int endIndex, Microsoft.VisualStudio.Text.SpanTrackingMode trackingMode);
abstract member Create : string * int * int * int * int * Microsoft.VisualStudio.Text.SpanTrackingMode -> Microsoft.VisualStudio.Text.IPersistentSpan
Public Function Create (filePath As String, startLine As Integer, startIndex As Integer, endLine As Integer, endIndex As Integer, trackingMode As SpanTrackingMode) As IPersistentSpan
Parameters
- filePath
- String
Name of the file that contains the span.
- startLine
- Int32
Line number of the start point.
- startIndex
- Int32
Character offset from the start of the line containing the start point.
- endLine
- Int32
Line number of the end point.
- endIndex
- Int32
Character offset from the start of the line containing the end point.
- trackingMode
- SpanTrackingMode
How the tracking span will react to changes at its boundaries.
Returns
The newly created span.
Remarks
Using this method to create an IPersistentSpan on a document that is already open is an error (and will prevent the span from tracking properly).