ITextStoreACP2::QueryInsert-Methode (textstor.h)

Artikel
03/04/2024

Bestimmt, ob die angegebenen Anfangs- und Endzeichenpositionen gültig sind. Verwenden Sie diese Methode, um eine Bearbeitung an ein Dokument anzupassen, bevor Sie die Bearbeitung ausführen. Die -Methode darf keine Werte außerhalb des Bereichs des Dokuments zurückgeben.

Syntax

HRESULT QueryInsert(
  [in]  LONG  acpTestStart,
  [in]  LONG  acpTestEnd,
  [in]  ULONG cch,
  [out] LONG  *pacpResultStart,
  [out] LONG  *pacpResultEnd
);

Parameter

[in] acpTestStart

Startzeichenposition für eingefügten Text.

[in] acpTestEnd

Endposition der Anwendungszeichen für den eingefügten Text. Dieser Wert ist gleich acpTextStart , wenn der Text an einem Punkt eingefügt wird, anstatt ausgewählten Text zu ersetzen.

[in] cch

Länge des Ersatztexts.

[out] pacpResultStart

Gibt die neue Startzeichenposition der Anwendung des eingefügten Texts zurück. Wenn dieser Parameter NULL ist, kann kein Text an der angegebenen Position eingefügt werden. Dieser Wert darf sich nicht außerhalb des Dokumentbereichs befinden.

[out] pacpResultEnd

Gibt die neue endende Anwendungszeichenposition des eingefügten Texts zurück. Wenn dieser Parameter NULL ist, wird pacpResultStart auf NULL festgelegt, und Text kann nicht an der angegebenen Position eingefügt werden. Dieser Wert darf sich nicht außerhalb des Dokumentbereichs 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 acpTestStart oder acpTestEnd sind ungültig.

Hinweise

Die Werte von pacpResultStart und pacpResultEnd hängen davon ab, wie die Anwendung Text in das Dokument einfügt. Wenn pacpResultStart und pacpResultEnd mit acpTextStart identisch sind, befindet sich der Cursor nach dem Einfügen am Anfang des eingefügten Texts. Wenn pacpResultStart und pacpResultEnd mit acpTextEnd identisch sind, befindet sich der Cursor nach dem Einfügen am Ende des eingefügten Texts. Wenn der Unterschied zwischen pacpResultStart und pacpResultEnd der Länge des eingefügten Texts entspricht, wird der eingefügte Text nach dem Einfügen hervorgehoben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	textstor.h
DLL	Msctf.dll

Weitere Informationen

ITextStoreACP2

Freigeben über