ITextStoreAnchor::QueryInsert-Methode (textstor.h)

Artikel
08/26/2023

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.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG	Die Parameter paTestStart oder paTestEnd sind ungültig.
E_OUTOFMEMORY	Fehler beim Instanziieren der ppaResultStart - und/oder ppaResultEnd-Anker .

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Freigeben über