IVsTextStream.CanReplaceStream Method

Article
11/25/2013

Tests whether a given editing operation can succeed (for example, copy or cut).

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

Syntax

'Declaration
Function CanReplaceStream ( _
    iPos As Integer, _
    iOldLen As Integer, _
    iNewLen As Integer _
) As Integer

int CanReplaceStream(
    int iPos,
    int iOldLen,
    int iNewLen
)

int CanReplaceStream(
    [InAttribute] int iPos, 
    [InAttribute] int iOldLen, 
    [InAttribute] int iNewLen
)

abstract CanReplaceStream : 
        iPos:int * 
        iOldLen:int * 
        iNewLen:int -> int

function CanReplaceStream(
    iPos : int, 
    iOldLen : int, 
    iNewLen : int
) : int

Parameters

iPos
Type: System.Int32

[in] Position in the text buffer.

iOldLen
Type: System.Int32

[in] Length of text to replace, if any. In an insert operation, this value is zero (0).

iNewLen
Type: System.Int32

[in] Length of the newly inserted text.

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 IVsTextStream::CanReplaceStream(
   [in] long iPos,
   [in] long iOldLen,
   [in] long iNewLen
);

In the text buffer, every change is modeled as a replace operation, regardless of whether text is inserted, replaced, or deleted within the line. As such, this method contains a starting position in the text buffer (iPos) and a length of text to replace (iOldLen). To test for an insert operation, set iOldLen to zero (0). To test whether text can be deleted, set iNewLen to zero (0) and then iOldLen would be greater than zero (0).

CanReplaceStream is used to test whether a given editing operation (for example, cut or copy) can succeed. Potential causes for failure include attempting to replace text in a read-only buffer (file is under source control), or attempting to replace text in a read-only region within the buffer.

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

Partager via