ITextStoreACP::InsertTextAtSelection-Methode (textstor.h)

Artikel
08/26/2023

Die ITextStoreACP::InsertTextAtSelection-Methode fügt Text an der Einfügemarke oder Auswahl ein. Ein Aufrufer muss über eine Lese-/Schreibsperre für das Dokument verfügen, bevor Text eingefügt wird.

Syntax

HRESULT InsertTextAtSelection(
  [in]  DWORD         dwFlags,
  [in]  const WCHAR   *pchText,
  [in]  ULONG         cch,
  [out] LONG          *pacpStart,
  [out] LONG          *pacpEnd,
  [out] TS_TEXTCHANGE *pChange
);

Parameter

[in] dwFlags

Gibt an, ob die Parameter pacpStart und pacpEnd sowie die TS_TEXTCHANGE Struktur die Ergebnisse der Texteinfügung enthalten.

Die flags TF_IAS_NOQUERY und TF_IAS_QUERYONLY können nicht kombiniert werden.

Wert	Bedeutung
0	Das Einfügen von Text erfolgt, und die Parameter pacpStart und pacpEnd enthalten die Ergebnisse der Texteinfügung. Die TS_TEXTCHANGE-Struktur muss mit diesem Flag gefüllt werden.
TF_IAS_NOQUERY	Text wird eingefügt, die Werte der Parameter pacpStart und pacpEnd können NULL sein, und die TS_TEXTCHANGE Struktur muss ausgefüllt werden. Verwenden Sie dieses Flag, um die Ergebnisse der Texteinfügung anzuzeigen.
TF_IAS_QUERYONLY	Text wird nicht eingefügt, und die Werte für die Parameter pacpStart und pacpEnd enthalten die Ergebnisse der Texteinfügung. Die Werte dieser Parameter hängen davon ab, wie die Anwendung das Einfügen von Text in ein Dokument implementiert. Weitere Informationen finden Sie im Abschnitt mit Hinweisen. Verwenden Sie dieses Flag, um die Ergebnisse der Texteinfügung anzuzeigen, ohne den Text tatsächlich einzufügen. Es ist nicht erforderlich, dass Sie die TS_TEXTCHANGE-Struktur ausfüllen, wenn Sie dieses Flag verwenden.

[in] pchText

Zeiger auf die Zeichenfolge, die in das Dokument eingefügt werden soll. Die Zeichenfolge kann NULL beendet sein.

[in] cch

Gibt die Textlänge an.

[out] pacpStart

Zeiger auf die Anfangszeichenposition der Anwendung, an der die Texteinfügung erfolgt.

[out] pacpEnd

Zeiger auf die endende Anwendungszeichenposition, an der der Text eingefügt wird. Dieser Parameterwert ist mit dem Wert des pacpStart-Parameters für eine Einfügemarke identisch.

[out] pChange

Zeiger auf eine TS_TEXTCHANGE-Struktur mit den folgenden Membern.

Wert	Bedeutung
acpStart	Die Anfangsposition des Anwendungszeichens, bevor der Text in das Dokument eingefügt wird.
acpOldEnd	Die endende Anwendungszeichenposition, bevor der Text in das Dokument eingefügt wird. Dieser Wert ist mit acpStart für eine Einfügemarke identisch. Wenn sich dieser Wert von acpStart unterscheidet, wurde text vor der Texteinfügung ausgewählt.
acpNewEnd	Die Endposition nach dem Einfügen von Text.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine Sperre für das Dokument.
E_INVALIDARG	Der pchText-Parameter ist ungültig.

Hinweise

Die Werte der Parameter pacpStart und pacpEnd hängen davon ab, wie die Clientanwendung Text in ein Dokument einfügt. Wenn die Anwendung beispielsweise den Cursor am Anfang des eingefügten Texts nach dem Einfügen von Text festlegt, ist der Wert für die Parameter pacpStart und pacpEnd mit dem acpStart-Element der TS_TEXTCHANGE-Struktur identisch.

Anwendungen sollten die ITextStoreACPSink::OnTextChange-Methode als Antwort auf diese Methode nicht aufrufen.

Anforderungen

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

Weitere Informationen

Kompositionen

Itextstoreacp

ITextStoreACPSink::OnTextChange

TF_IAS_*-Konstanten

TS_TEXTCHANGE

Freigeben über