IVsTextManager.NavigateToPosition Method

Article
11/19/2013

Finds or creates an appropriate view on the specified buffer and puts the selection on the specified linear position.

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

Syntax

'Declaration
Function NavigateToPosition ( _
    pBuffer As IVsTextBuffer, _
    ByRef guidDocViewType As Guid, _
    iPos As Integer, _
    iLen As Integer _
) As Integer

int NavigateToPosition(
    IVsTextBuffer pBuffer,
    ref Guid guidDocViewType,
    int iPos,
    int iLen
)

int NavigateToPosition(
    [InAttribute] IVsTextBuffer^ pBuffer, 
    [InAttribute] Guid% guidDocViewType, 
    [InAttribute] int iPos, 
    [InAttribute] int iLen
)

abstract NavigateToPosition : 
        pBuffer:IVsTextBuffer * 
        guidDocViewType:Guid byref * 
        iPos:int * 
        iLen:int -> int

function NavigateToPosition(
    pBuffer : IVsTextBuffer, 
    guidDocViewType : Guid, 
    iPos : int, 
    iLen : int
) : int

Parameters

pBuffer
Type: Microsoft.VisualStudio.TextManager.Interop.IVsTextBuffer

[in] Pointer to the IVsTextBuffer interface.

guidDocViewType
Type: System.Guid%

[in] GUID identifying the view. This value should always be LOGVIEWID_TextView.

iPos
Type: System.Int32

[in] Linear position in buffer on which to put the caret.

iLen
Type: System.Int32

[in] Length of selection.

Return Value

Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From textmgr.idl:

HRESULT IVsTextManager::NavigateToPosition(
   [in] IVsTextBuffer * pBuffer,
   [in] REFGUID guidDocViewType,
   [in] long iPos,
   [in] long iLen
);

This method is the same as NavigateToLineAndColumn, except that it uses one-dimensional, positional coordinates.

.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.

Share via