IVsTextLines.ReplaceLinesEx Method

2012-09-25

Handles stream-like line editing, such as line breaking and line joining.

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

Syntax

'Declaration
Function ReplaceLinesEx ( _
    dwFlags As UInteger, _
    iStartLine As Integer, _
    iStartIndex As Integer, _
    iEndLine As Integer, _
    iEndIndex As Integer, _
    pszText As IntPtr, _
    iNewLen As Integer, _
    <OutAttribute> pChangedSpan As TextSpan() _
) As Integer

'Usage
Dim instance As IVsTextLines 
Dim dwFlags As UInteger 
Dim iStartLine As Integer 
Dim iStartIndex As Integer 
Dim iEndLine As Integer 
Dim iEndIndex As Integer 
Dim pszText As IntPtr 
Dim iNewLen As Integer 
Dim pChangedSpan As TextSpan()
Dim returnValue As Integer 

returnValue = instance.ReplaceLinesEx(dwFlags, _
    iStartLine, iStartIndex, iEndLine, _
    iEndIndex, pszText, iNewLen, pChangedSpan)

int ReplaceLinesEx(
    uint dwFlags,
    int iStartLine,
    int iStartIndex,
    int iEndLine,
    int iEndIndex,
    IntPtr pszText,
    int iNewLen,
    TextSpan[] pChangedSpan
)

int ReplaceLinesEx(
    [InAttribute] unsigned int dwFlags, 
    [InAttribute] int iStartLine, 
    [InAttribute] int iStartIndex, 
    [InAttribute] int iEndLine, 
    [InAttribute] int iEndIndex, 
    [InAttribute] IntPtr pszText, 
    [InAttribute] int iNewLen, 
    [OutAttribute] array<TextSpan>^ pChangedSpan
)

function ReplaceLinesEx(
    dwFlags : uint, 
    iStartLine : int, 
    iStartIndex : int, 
    iEndLine : int, 
    iEndIndex : int, 
    pszText : IntPtr, 
    iNewLen : int, 
    pChangedSpan : TextSpan[]
) : int

Parameters

dwFlags
Type: System.UInt32

[in] ORing of REPLACE_TEXT_FLAGS enum.

iStartLine
Type: System.Int32

[in] Starting line

iStartIndex
Type: System.Int32

[in] Starting character index within the line. Must be less than or equal to the length of the line.

iEndLine
Type: System.Int32

[in] Ending line.

iEndIndex
Type: System.Int32

[in] Ending character index within the line. Must be less than or equal to the length of the line.

pszText
Type: System.IntPtr

[in] Pointer to text to insert, if any.

iNewLen
Type: System.Int32

[in] Number of characters to insert, if any.

pChangedSpan
Type: array<Microsoft.VisualStudio.TextManager.Interop.TextSpan[]

[out] Pointer to the range of characters changed.

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 IVsTextLines::ReplaceLinesEx(
   [in] DWORD dwFlags,
   [in] long iStartLine,
   [in] CharIndex iStartIndex,
   [in] long iEndLine,
   [in] CharIndex iEndIndex,
   [in] LPCWSTR pszText,
   [in] long iNewLen,
   [out] TextSpan *pChangedSpan
);

Similar to ReplaceLines, but allows you to specify additional options in the dwFlags parameter.

.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