IVsTextManager.NavigateToLineAndColumn Method

Article
11/25/2013

Finds or creates an appropriate view on the specified buffer and places the selection at the specified location.

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

Syntax

'Declaration
Function NavigateToLineAndColumn ( _
    pBuffer As IVsTextBuffer, _
    ByRef guidDocViewType As Guid, _
    iStartRow As Integer, _
    iStartIndex As Integer, _
    iEndRow As Integer, _
    iEndIndex As Integer _
) As Integer

int NavigateToLineAndColumn(
    IVsTextBuffer pBuffer,
    ref Guid guidDocViewType,
    int iStartRow,
    int iStartIndex,
    int iEndRow,
    int iEndIndex
)

int NavigateToLineAndColumn(
    [InAttribute] IVsTextBuffer^ pBuffer, 
    [InAttribute] Guid% guidDocViewType, 
    [InAttribute] int iStartRow, 
    [InAttribute] int iStartIndex, 
    [InAttribute] int iEndRow, 
    [InAttribute] int iEndIndex
)

abstract NavigateToLineAndColumn : 
        pBuffer:IVsTextBuffer * 
        guidDocViewType:Guid byref * 
        iStartRow:int * 
        iStartIndex:int * 
        iEndRow:int * 
        iEndIndex:int -> int

function NavigateToLineAndColumn(
    pBuffer : IVsTextBuffer, 
    guidDocViewType : Guid, 
    iStartRow : int, 
    iStartIndex : int, 
    iEndRow : int, 
    iEndIndex : 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.

iStartRow
Type: System.Int32

[in] Starting line for the selection to locate.

iStartIndex
Type: System.Int32

[in] Starting index for the selection to locate.

iEndRow
Type: System.Int32

[in] Ending line for the selection to locate.

iEndIndex
Type: System.Int32

[in] Ending index for the selection to locate.

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::NavigateToLineAndColumn(
   [in] IVsTextBuffer* pBuffer,
   [in] REFGUID guidDocViewType,
   [in] long iStartRow,
   [in] CharIndex iStartIndex,
   [in] long iEndRow,
   [in] CharIndex iEndIndex
);

To use this method, pass in a pointer to a text buffer and a line/column position in that buffer. The method then locates the buffer, displays a view if the view is not currently active, and then places selection at the specified span of text.

.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