Partager via


IVsTextTrackingPoint Interface

Establishes and maintains an internal tracking point.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop (in Microsoft.VisualStudio.TextManager.Interop.dll)

Syntax

'Déclaration
<InterfaceTypeAttribute()> _
<GuidAttribute("D6BF0A8A-3798-49C5-8806-648A635EACC8")> _
Public Interface IVsTextTrackingPoint
[InterfaceTypeAttribute()]
[GuidAttribute("D6BF0A8A-3798-49C5-8806-648A635EACC8")]
public interface IVsTextTrackingPoint
[InterfaceTypeAttribute()]
[GuidAttribute(L"D6BF0A8A-3798-49C5-8806-648A635EACC8")]
public interface class IVsTextTrackingPoint
[<InterfaceTypeAttribute()>]
[<GuidAttribute("D6BF0A8A-3798-49C5-8806-648A635EACC8")>]
type IVsTextTrackingPoint =  interface end
public interface IVsTextTrackingPoint

The IVsTextTrackingPoint type exposes the following members.

Methods

  Name Description
Public method GetBehavior Gets the tracking point behavior.
Public method GetCurrentLineIndex Gets the tracking point current line and index.
Public method GetTextLayer Gets the tracking point’s text layer.
Public method SetBehavior Sets the tracking point’s behavior.

Top

Remarks

When tracking certain positions, such as the current selection, it is necessary to track a location in layer-generated text, that is, text produced by the synthetic text layer, yet still be able to track the location even if that layer goes away.

The solution is a track point object, which is like a marker except that it is guaranteed to keep tracking, possibly in a different layer, for as long as the buffer lives. Put another way, a multi-layer track point is similar to a zero-length marker, but it is guaranteed to always have a meaningful location in one of the layers, provided the buffer continues to exist. A track point never shows UI, and its position may not be reset. The only things you can do with track points are create them and query their layer and current line/index.

This interface is used only in special-purpose scenarios. Unless you need to track a point which may exist in a synthetic text region, you will not need to use this interface. Clients should normally use ordinary text markers on the buffer.

See Also

Reference

Microsoft.VisualStudio.TextManager.Interop Namespace