ITextStoreAnchor::QueryInsert method (textstor.h)

The ITextStoreAnchor::QueryInsert method determines whether the specified start and end anchors are valid. Use this method to adjust an edit to a document before you execute the edit. The method must not return values outside the range of the document.

Syntax

HRESULT QueryInsert(
  [in]  IAnchor *paTestStart,
  [in]  IAnchor *paTestEnd,
  [in]  ULONG   cch,
  [out] IAnchor **ppaResultStart,
  [out] IAnchor **ppaResultEnd
);

Parameters

[in] paTestStart

Receives a pointer to a start anchor for the inserted text.

[in] paTestEnd

Receives a pointer to an end anchor for the inserted text. This is the same as paTestStart if the text is inserted at a point instead of replacing selected text.

[in] cch

Length of replacement text.

[out] ppaResultStart

Pointer to the new anchor object at the starting location for the inserted text. If the value of this parameter is NULL, then text cannot be inserted at the specified position. This anchor cannot be outside the document.

[out] ppaResultEnd

Pointer to the new anchor object at the ending location for the inserted text. If the value of this parameter is NULL, then text cannot be inserted at the specified position. This anchor cannot be outside the document.

Return value

This method can return one of these values.

Remarks

The values of ppaResultStart and ppaResultEnd depend upon how the application inserts text into the document. If ppaResultStart and ppaResultEnd are the same as paTestStart, the cursor is at the beginning of the inserted text after insertion. If ppaResultStart and ppaResultEnd are the same as paTextEnd, the cursor is at the end of the inserted text after insertion.

Requirements