ITextStructureNavigatorSelectorService.CreateTextStructureNavigator Method
Creates a new ITextStructureNavigator for the specified ITextBuffer by using the specified IContentType to select the navigator.
Namespace: Microsoft.VisualStudio.Text.Operations
Assembly: Microsoft.VisualStudio.Text.Logic (in Microsoft.VisualStudio.Text.Logic.dll)
Syntax
'Declaration
Function CreateTextStructureNavigator ( _
textBuffer As ITextBuffer, _
contentType As IContentType _
) As ITextStructureNavigator
ITextStructureNavigator CreateTextStructureNavigator(
ITextBuffer textBuffer,
IContentType contentType
)
ITextStructureNavigator^ CreateTextStructureNavigator(
ITextBuffer^ textBuffer,
IContentType^ contentType
)
abstract CreateTextStructureNavigator :
textBuffer:ITextBuffer *
contentType:IContentType -> ITextStructureNavigator
function CreateTextStructureNavigator(
textBuffer : ITextBuffer,
contentType : IContentType
) : ITextStructureNavigator
Parameters
- textBuffer
Type: Microsoft.VisualStudio.Text.ITextBuffer
The ITextBuffer that the ITextStructureNavigator will navigate.
- contentType
Type: Microsoft.VisualStudio.Utilities.IContentType
The content type to use.
Return Value
Type: Microsoft.VisualStudio.Text.Operations.ITextStructureNavigator
A valid ITextStructureNavigator. This value is never nulla null reference (Nothing in Visual Basic).
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | textBuffer is nulla null reference (Nothing in Visual Basic). |
Remarks
If a navigator for the given content type cannot be found, this method uses 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.
The navigator that is created is not cached; subsequent calls to this method for the same buffer and content type will return different ITextStructureNavigator objects.
.NET Framework Security
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.