IVsTextLines.CreateLineMarker Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a marker of a given type over the specified region.
public:
int CreateLineMarker(int iMarkerType, int iStartLine, int iStartIndex, int iEndLine, int iEndIndex, Microsoft::VisualStudio::TextManager::Interop::IVsTextMarkerClient ^ pClient, cli::array <Microsoft::VisualStudio::TextManager::Interop::IVsTextLineMarker ^> ^ ppMarker);
public:
int CreateLineMarker(int iMarkerType, int iStartLine, int iStartIndex, int iEndLine, int iEndIndex, Microsoft::VisualStudio::TextManager::Interop::IVsTextMarkerClient ^ pClient, Platform::Array <Microsoft::VisualStudio::TextManager::Interop::IVsTextLineMarker ^> ^ ppMarker);
int CreateLineMarker(int iMarkerType, int iStartLine, int iStartIndex, int iEndLine, int iEndIndex, Microsoft::VisualStudio::TextManager::Interop::IVsTextMarkerClient const & pClient, std::Array <Microsoft::VisualStudio::TextManager::Interop::IVsTextLineMarker const &> const & ppMarker);
public int CreateLineMarker (int iMarkerType, int iStartLine, int iStartIndex, int iEndLine, int iEndIndex, Microsoft.VisualStudio.TextManager.Interop.IVsTextMarkerClient pClient, Microsoft.VisualStudio.TextManager.Interop.IVsTextLineMarker[] ppMarker);
abstract member CreateLineMarker : int * int * int * int * int * Microsoft.VisualStudio.TextManager.Interop.IVsTextMarkerClient * Microsoft.VisualStudio.TextManager.Interop.IVsTextLineMarker[] -> int
Public Function CreateLineMarker (iMarkerType As Integer, iStartLine As Integer, iStartIndex As Integer, iEndLine As Integer, iEndIndex As Integer, pClient As IVsTextMarkerClient, ppMarker As IVsTextLineMarker()) As Integer
Parameters
- iMarkerType
- Int32
[in] Type of marker to create.
- iStartLine
- Int32
[in] Starting line.
- iStartIndex
- Int32
[in] Starting character index within the line. Must be less than or equal to the length of the line.
- iEndLine
- Int32
[in] Ending line.
- iEndIndex
- Int32
[in] Ending character index within the line. Must be less than or equal to the length of the line.
- pClient
- 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
- IVsTextLineMarker[]
[out] Pointer to the IVsTextLineMarker interface (that is, the text marker). If this parameter is null, then the marker is owned by the text buffer. An example of a buffer-owned marker is a temporary bookmark.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From textmgr.idl:
HRESULT IVsTextLines::CreateLineMarker(
[in] long iMarkerType,
[in] long iStartLine,
[in] CharIndex iStartIndex,
[in] long iEndLine,
[in] CharIndex iEndIndex,
[in] IVsTextMarkerClient * pClient,
[out] IVsTextLineMarker ** 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.
Note
The markers created using IVsTextLines.CreateLineMarker
are line-oriented markers. Use CreateStreamMarker to create stream-oriented markers.