TextSnapshotRange Struct

public struct TextSnapshotRange : ITextPositionRangeProvider, ITextRangeProvider

public TextSnapshotRange(ITextSnapshot snapshot, TextRange textRange)

Parameter	Type	Description
snapshot	ITextSnapshot	The ITextSnapshot that contains the text range.
textRange	TextRange	The TextRange of the range.

public TextSnapshotRange(ITextSnapshot snapshot, int offset)

Parameter	Type	Description
snapshot	ITextSnapshot	The ITextSnapshot that contains the text range.
offset	System.Int32	The start and end offset in the range.

public TextSnapshotRange(ITextSnapshot snapshot, int startOffset, int endOffset)

Parameter	Type	Description
snapshot	ITextSnapshot	The ITextSnapshot that contains the text range.
startOffset	System.Int32	The start offset in the range.
endOffset	System.Int32	The end offset in the range.

public TextSnapshotRange(TextSnapshotOffset snapshotOffset)

Parameter	Type	Description
snapshotOffset	TextSnapshotOffset	The start and end offset in the range.

public int AbsoluteLength { get; }

Property Value

System.Int32:

The absolute number of characters encompassed by the TextSnapshotRange.

Remarks

This value will always return a positive length, even if the range is not normalized.

public static TextSnapshotRange Deleted { get; }

Property Value

TextSnapshotRange:

A TextSnapshotRange that has no Snapshot and is flagged as deleted.

public ITextSnapshotLine EndLine { get; }

Property Value

ITextSnapshotLine:

The ITextSnapshotLine that contains the end offset in the text range.

public int EndOffset { get; }

Property Value

System.Int32:

The end offset in the range.

Remarks

Since snapshot ranges are normalized, this property returns the last offset in the range.

public TextPosition EndPosition { get; }

Property Value

TextPosition:

The end TextPosition in the range.

Remarks

Since snapshot ranges are normalized, this property returns the last TextPosition in the range.

public bool IsDeleted { get; }

Property Value

System.Boolean:

true if the range has been flagged as deleted; otherwise, false.

public bool IsZeroLength { get; }

Property Value

System.Boolean:

true if the range has a zero length; otherwise, false.

public int Length { get; }

Property Value

System.Int32:

The number of characters encompassed by the TextSnapshotRange.

Remarks

This value will return a negative length if the range is not normalized.

public TextPositionRange PositionRange { get; }

Property Value

TextPositionRange:

A TextPositionRange that specifies the text position range of the object.

public ITextSnapshot Snapshot { get; }

Property Value

ITextSnapshot:

The ITextSnapshot that contains the text range.

public ITextSnapshotLine StartLine { get; }

Property Value

ITextSnapshotLine:

The ITextSnapshotLine that contains the start offset in the text range.

public int StartOffset { get; }

Property Value

System.Int32:

The start offset in the range.

Remarks

Since snapshot ranges are normalized, this property returns the first offset in the range.

public TextPosition StartPosition { get; }

Property Value

TextPosition:

The start TextPosition in the range.

Remarks

Since snapshot ranges are normalized, this property returns the first TextPosition in the range.

public string Text { get; }

Property Value

System.String:

The snapshot text substring encompassed by this range, using CarriageReturnNewline for line ends.

public TextRange TextRange { get; }

Property Value

TextRange:

A TextRange that specifies the text range of the object.

public bool BordersOn(TextRange range)

Parameter	Type	Description
range	TextRange	The TextRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange borders on, but does not overlap the specified TextRange; otherwise, false.

public bool BordersOn(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange borders on, but does not overlap the specified TextSnapshotRange; otherwise, false.

public bool BordersOn(int offset)

Parameter	Type	Description
offset	System.Int32	The offset to examine.

Returns

System.Boolean:

true if the TextSnapshotRange borders on the specified offset; otherwise, false.

Remarks

This method checks to see if the specified offset is either the StartOffset or EndOffset.

public int CompareTo(TextRange range)

Parameter	Type	Description
range	TextRange	A TextRange to compare with this instance.

Returns

System.Int32:

A 32-bit signed integer that indicates the relative order of the comparands.

public int CompareTo(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	A TextSnapshotRange to compare with this instance.

Returns

System.Int32:

A 32-bit signed integer that indicates the relative order of the comparands.

public bool Contains(TextRange range)

Parameter	Type	Description
range	TextRange	The TextRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange contains the specified TextRange; otherwise, false.

public bool Contains(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange contains the specified TextSnapshotRange; otherwise, false.

public bool Contains(int offset)

Parameter	Type	Description
offset	System.Int32	The offset to examine.

Returns

System.Boolean:

true if the TextSnapshotRange contains the specified offset; otherwise, false.

Remarks

This method returns false if the offset falls on the EndOffset offset since this method indicates if the offset is encompassed by the TextSnapshotRange.

public override bool Equals(object obj)

Parameter	Type	Description
obj	System.Object	The Object to compare to the current Object.

Returns

System.Boolean:

true if the specified Object is equal to the current Object; otherwise, false.

public static TextSnapshotRange FromSpan(ITextSnapshot snapshot, int offset, int length)

Parameter	Type	Description
snapshot	ITextSnapshot	The ITextSnapshot that contains the text range.
offset	System.Int32	The start offset.
length	System.Int32	The length of the range.

Returns

TextSnapshotRange:

The TextSnapshotRange that was created.

public override int GetHashCode()

Returns

System.Int32:

An integer value that specifies a hash value for this object.

public string GetText(LineTerminator lineTerminator)

Parameter	Type	Description
lineTerminator	LineTerminator	A LineTerminator specifying the type of line terminators to use.

Returns

System.String:

The snapshot text substring encompassed by this range, using the specified LineTerminator for line ends.

public bool IntersectsWith(TextRange range)

Parameter	Type	Description
range	TextRange	The TextRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange intersects with the specified TextRange; otherwise, false.

Remarks

This method returns whether the specified TextRange borders on or overlaps the TextSnapshotRange.

public bool IntersectsWith(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange intersects with the specified TextSnapshotRange; otherwise, false.

Remarks

This method returns whether the specified TextSnapshotRange borders on or overlaps the TextSnapshotRange.

public bool IntersectsWith(TextSnapshotRange range, bool includeFirstEdge, bool includeLastEdge)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to examine.
includeFirstEdge	System.Boolean	Whether to return true if the specified TextSnapshotRange borders on the leading (first) edge of this TextSnapshotRange.
includeLastEdge	System.Boolean	Whether to return true if the specified TextSnapshotRange borders on the trailing (last) edge of this TextSnapshotRange.

Returns

System.Boolean:

true if the TextSnapshotRange intersects with the specified TextSnapshotRange; otherwise, false.

Remarks

This method returns whether the specified TextSnapshotRange borders on or overlaps the TextSnapshotRange.

public bool IntersectsWith(int offset)

Parameter	Type	Description
offset	System.Int32	The offset to examine.

Returns

System.Boolean:

true if the TextSnapshotRange intersects with the specified offset; otherwise, false.

Remarks

This method returns whether the specified offset borders on or lies within the TextSnapshotRange.

public bool OverlapsWith(TextRange range)

Parameter	Type	Description
range	TextRange	The TextRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange overlaps with, or crosses, the specified TextRange; otherwise, false.

public bool OverlapsWith(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to examine.

Returns

System.Boolean:

true if the TextSnapshotRange overlaps with, or crosses, the specified TextSnapshotRange; otherwise, false.

public override string ToString()

Returns

System.String:

A string whose value represents this object.

public ITextVersionRange ToVersionRange(TextRangeTrackingModes trackingModes)

Parameter	Type	Description
trackingModes	TextRangeTrackingModes	A TextRangeTrackingModes indicating the tracking modes to use.

Returns

ITextVersionRange:

The ITextVersionRange that was created.

public ITextVersionRange ToVersionRange(Func<TextRangeTrackingModes> trackingModesFunc)

Parameter	Type	Description
trackingModesFunc	System.Func<TextRangeTrackingModes>	A function that dynamically returns a TextRangeTrackingModes indicating the tracking modes to use.

Returns

ITextVersionRange:

The ITextVersionRange that was created.

public TextSnapshotRange TranslateTo(ITextSnapshot toSnapshot, TextRangeTrackingModes trackingModes)

Parameter	Type	Description
toSnapshot	ITextSnapshot	The ITextSnapshot that is the target of the translation.
trackingModes	TextRangeTrackingModes	A TextRangeTrackingModes indicating the tracking modes to use.

Returns

TextSnapshotRange:

The translated TextSnapshotRange.

public static bool operator ==(TextSnapshotRange left, TextSnapshotRange right)

Parameter	Type	Description
left	TextSnapshotRange	A TextSnapshotRange to compare.
right	TextSnapshotRange	A TextSnapshotRange to compare.

Returns

System.Boolean:

true if the StartOffset and EndOffset values of left and right are equal; otherwise, false.

public static bool operator>(TextSnapshotRange left, TextSnapshotRange right)

Parameter	Type	Description
left	TextSnapshotRange	A TextSnapshotRange to compare.
right	TextSnapshotRange	A TextSnapshotRange to compare.

Returns

System.Boolean:

true if the TextSnapshotRange in left is greater than the TextSnapshotRange in right; otherwise, false.

public static implicit operator TextRange(TextSnapshotRange range)

Parameter	Type	Description
range	TextSnapshotRange	The TextSnapshotRange to convert.

Returns

TextRange:

The TextRange result.

public static bool operator !=(TextSnapshotRange left, TextSnapshotRange right)

Parameter	Type	Description
left	TextSnapshotRange	A TextSnapshotRange to compare.
right	TextSnapshotRange	A TextSnapshotRange to compare.

Returns

System.Boolean:

true if the StartOffset and EndOffset values of left and right are unequal; otherwise, false.

public static bool operator <(TextSnapshotRange left, TextSnapshotRange right)

Parameter	Type	Description
left	TextSnapshotRange	A TextSnapshotRange to compare.
right	TextSnapshotRange	A TextSnapshotRange to compare.

Returns

System.Boolean:

true if the TextSnapshotRange in left is less than the TextSnapshotRange in right; otherwise, false.

TextPositionRange ITextPositionRangeProvider.PositionRange { get; set; }

Returns

TextPositionRange:

A TextPositionRange that specifies the text position range of the object.

TextRange ITextRangeProvider.TextRange { get; set; }

Returns

TextRange:

A TextRange that specifies the text range of the object.