ITextStoreAnchor::QueryInsert-Methode (textstor.h)

Die ITextStoreAnchor::QueryInsert-Methode bestimmt, ob die angegebenen Start- und Endanker gültig sind. Verwenden Sie diese Methode, um eine Bearbeitung an einem Dokument anzupassen, bevor Sie die Bearbeitung ausführen. Die -Methode darf keine Werte zurückgeben, die außerhalb des Bereichs des Dokuments liegen.

Syntax

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

Parameter

[in] paTestStart

Empfängt einen Zeiger auf einen Startanker für den eingefügten Text.

[in] paTestEnd

Empfängt einen Zeiger auf einen Endanker für den eingefügten Text. Dies entspricht paTestStart , wenn der Text an einem Punkt eingefügt wird, anstatt den markierten Text zu ersetzen.

[in] cch

Länge des Ersatztexts.

[out] ppaResultStart

Zeiger auf das neue Ankerobjekt an der Startposition für den eingefügten Text. Wenn der Wert dieses Parameters NULL ist, kann kein Text an der angegebenen Position eingefügt werden. Dieser Anker darf sich nicht außerhalb des Dokuments befinden.

[out] ppaResultEnd

Zeiger auf das neue Ankerobjekt an der Endposition für den eingefügten Text. Wenn der Wert dieses Parameters NULL ist, kann kein Text an der angegebenen Position eingefügt werden. Dieser Anker darf sich nicht außerhalb des Dokuments befinden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Die Werte von ppaResultStart und ppaResultEnd hängen davon ab, wie die Anwendung Text in das Dokument einfügt. Wenn ppaResultStart und ppaResultEnd mit paTestStart identisch sind, befindet sich der Cursor nach dem Einfügen am Anfang des eingefügten Texts. Wenn ppaResultStart und ppaResultEnd mit paTextEnd identisch sind, befindet sich der Cursor nach dem Einfügen am Ende des eingefügten Texts.

Anforderungen