IVsTextLines.ReplaceLinesEx Method

Article
05/06/2010

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

'Déclaration
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
'Utilisation
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
)

abstract ReplaceLinesEx : 
        dwFlags:uint32 * 
        iStartLine:int * 
        iStartIndex:int * 
        iEndLine:int * 
        iEndIndex:int * 
        pszText:IntPtr * 
        iNewLen:int * 
        pChangedSpan:TextSpan[] byref -> int

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.