ITextStoreACP::QueryInsert-Methode (textstor.h)

Die ITextStoreACP::QueryInsert-Methode bestimmt, ob die angegebenen Start- 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.

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