ITextStructureNavigatorSelectorService.GetTextStructureNavigator Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Text.Operations

Assembly:: Microsoft.VisualStudio.Text.Logic.dll

Package:: Microsoft.VisualStudio.Text.Logic v17.12.215

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.

Gets a ITextStructureNavigator for the specified ITextBuffer, either by creating a new one or by using a cached value.

public:
 Microsoft::VisualStudio::Text::Operations::ITextStructureNavigator ^ GetTextStructureNavigator(Microsoft::VisualStudio::Text::ITextBuffer ^ textBuffer);

public:
 Microsoft::VisualStudio::Text::Operations::ITextStructureNavigator ^ GetTextStructureNavigator(Microsoft::VisualStudio::Text::ITextBuffer ^ textBuffer);

Microsoft::VisualStudio::Text::Operations::ITextStructureNavigator GetTextStructureNavigator(Microsoft::VisualStudio::Text::ITextBuffer const & textBuffer);

public Microsoft.VisualStudio.Text.Operations.ITextStructureNavigator GetTextStructureNavigator (Microsoft.VisualStudio.Text.ITextBuffer textBuffer);

abstract member GetTextStructureNavigator : Microsoft.VisualStudio.Text.ITextBuffer -> Microsoft.VisualStudio.Text.Operations.ITextStructureNavigator

Public Function GetTextStructureNavigator (textBuffer As ITextBuffer) As ITextStructureNavigator

Parameters

textBuffer: ITextBuffer

The ITextBuffer that the ITextStructureNavigator will navigate.

Returns

ITextStructureNavigator

A valid ITextStructureNavigator. This value will never be null.

Exceptions

ArgumentNullException

textBuffer is null.

Remarks

If a navigator for the exact IContentType of the given ITextBuffer cannot be found, this method returns one for the parent IContentType. If there is more than one parent IContentType for which there is a matching ITextStructureNavigator, then this method returns the ITextStructureNavigator of an arbitrary parent.

If a new navigator is created, it is cached together with textBuffer, and its lifetime is the same as that of textBuffer.

Applies to

Compartilhar via