IVsTextStream.CreateStreamMarker Method

Article
05/06/2010

Creates a stream marker of a given type over the specified region.

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

Syntax

'Déclaration
Function CreateStreamMarker ( _
    iMarkerType As Integer, _
    iPos As Integer, _
    iLength As Integer, _
    pClient As IVsTextMarkerClient, _
    <OutAttribute> ppMarker As IVsTextStreamMarker() _
) As Integer
'Utilisation
Dim instance As IVsTextStream
Dim iMarkerType As Integer
Dim iPos As Integer
Dim iLength As Integer
Dim pClient As IVsTextMarkerClient
Dim ppMarker As IVsTextStreamMarker()
Dim returnValue As Integer

returnValue = instance.CreateStreamMarker(iMarkerType, _
    iPos, iLength, pClient, ppMarker)

int CreateStreamMarker(
    int iMarkerType,
    int iPos,
    int iLength,
    IVsTextMarkerClient pClient,
    IVsTextStreamMarker[] ppMarker
)

int CreateStreamMarker(
    [InAttribute] int iMarkerType, 
    [InAttribute] int iPos, 
    [InAttribute] int iLength, 
    [InAttribute] IVsTextMarkerClient^ pClient, 
    [OutAttribute] array<IVsTextStreamMarker^>^ ppMarker
)

abstract CreateStreamMarker : 
        iMarkerType:int * 
        iPos:int * 
        iLength:int * 
        pClient:IVsTextMarkerClient * 
        ppMarker:IVsTextStreamMarker[] byref -> int

function CreateStreamMarker(
    iMarkerType : int, 
    iPos : int, 
    iLength : int, 
    pClient : IVsTextMarkerClient, 
    ppMarker : IVsTextStreamMarker[]
) : int

Parameters

iMarkerType
Type: System.Int32
[in] Type of marker to create.

iPos
Type: System.Int32
[in] Starting position in the text buffer.

iLength
Type: System.Int32
[in] Length of text to create marker over.

pClient
Type: Microsoft.VisualStudio.TextManager.Interop.IVsTextMarkerClient
[in] Pointer to the IVsTextMarkerClient interface. Implement this interface to advise the text buffer that you want to receive notification of marker events.

ppMarker
Type: array<Microsoft.VisualStudio.TextManager.Interop.IVsTextStreamMarker[]
[out] Pointer to the IVsTextStreamMarker interface. If this parameter is nulla null reference (Nothing in Visual Basic), then the text marker is owned by the text buffer. An example of a buffer-owned text marker is a temporary bookmark.

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::CreateStreamMarker(
   [in] long iMarkerType,
   [in] long iPos,
   [in] long iLength,
   [in] IVsTextMarkerClient *pClient,
   [out] IVsTextStreamMarker **ppMarker
);

This method creates a marker over the specified region. If you want to listen to marker events for the buffer, then pass in a pointer to the IVsTextMarkerClient interface in the pClient parameter.

Notes

The markers created using CreateStreamMarker are stream-oriented markers. Use M:Microsoft.VisualStudio.TextManager.Interop.IVsTextLines.CreateLineMarker(System.Int32,System.Int32,System.Int32,System.Int32,System.Int32,Microsoft.VisualStudio.TextManager.Interop.IVsTextMarkerClient,Microsoft.VisualStudio.TextManager.Interop.IVsTextLineMarker[]) to create line-oriented markers.

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