ITextStoreAnchor::InsertTextAtSelection-Methode (textstor.h)

Artikel
08/26/2023

Fügt Text an der Einfügemarke oder Auswahl ein.

Syntax

HRESULT InsertTextAtSelection(
  [in]  DWORD       dwFlags,
  [in]  const WCHAR *pchText,
  [in]  ULONG       cch,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parameter

[in] dwFlags

Gibt an, ob die Parameter paStart und paEnd die Ergebnisse der Texteinfügung enthalten.

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

Wert	Bedeutung
TF_IAS_NOQUERY	Text wird eingefügt, und die Werte der Parameter ppaStart und ppaEnd können NULL sein. Verwenden Sie dieses Flag, wenn die Ergebnisse der Texteinfügung nicht erforderlich sind.
TF_IAS_QUERYONLY	Text wird nicht eingefügt, und die Anker ppaStart und ppaEnd 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. Verwenden Sie dieses Flag, um die Ergebnisse der Texteinfügung anzuzeigen, ohne den Text tatsächlich einzufügen. Text der Länge null kann eingefügt werden.

[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] ppaStart

Zeiger auf das Ankerobjekt am Anfang der Texteinfügung.

[out] ppaEnd

Zeiger auf das Ankerobjekt am Ende der Texteinfügung. Bei einer Einfügemarke ist dieser Parameterwert mit dem Wert des ppaStart-Parameters identisch.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_FAIL	Die Methode konnte keinen der Anker paStart oder paEnd instanziieren.
E_INVALIDARG	Der pchText-Parameter ist ungültig.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine Sperre für das Dokument.

Anforderungen


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

Weitere Informationen

Kompositionen

ITextStoreAnchor

ITextStoreAnchorSink::OnTextChange

TF_IAS_*-Konstanten

TS_TEXTCHANGE

Freigeben über