ITfInsertAtSelection::InsertTextAtSelection-Methode (msctf.h)

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

Syntax

HRESULT InsertTextAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  const WCHAR  *pchText,
  [in]  LONG         cch,
  [out] ITfRange     **ppRange
);

Parameter

[in] ec

Identifiziert den Bearbeitungskontext. Dies wird von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen.

[in] dwFlags

Bitfeld mit einem der folgenden Werte.

Wert	Bedeutung
TF_IAS_NOQUERY	ppRange ist NULL. Dieses Flag kann nicht mit dem flag TF_IAS_QUERYONLY kombiniert werden.
TF_IAS_QUERYONLY	Der Kontext wird nicht geändert, aber ppRange wird so festgelegt, als ob die Einfügung erfolgt wäre. Schreibgeschützter Zugriff ist ausreichend. Wenn dieses Flag nicht festgelegt ist, muss ec über Lese-/Schreibzugriff verfügen. Dieses Flag kann nicht mit dem flag TF_IAS_NOQUERY kombiniert werden.
TF_IAS_NO_DEFAULT_COMPOSITION	Der Manager erstellt keine Standardkomposition, wenn eine Komposition erforderlich ist. Der Aufrufer muss ein Kompositionsobjekt erstellen, das den eingefügten Text abdeckt, bevor die Kontextsperre freigegeben wird.

[in] pchText

Gibt den einzufügenden Text an.

[in] cch

Gibt die Zeichenanzahl des Texts in pchText an.

[out] ppRange

Empfängt die Position des eingefügten Objekts.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_E_NOLOCK	Der Textdienst verfügt nicht über eine Dokumentsperre.
TF_E_DISCONNECTED	Das Kontextobjekt befindet sich nicht in einem Dokumentstapel.
TS_E_NOSELECTION	Der Kontext hat keine Auswahl.
TS_E_READONLY	Die Auswahl ist schreibgeschützt.

Hinweise

Verwenden Sie zum Einfügen eines IDataObject-Objekts anstelle von Text ITfInsertAtSelection::InsertEmbeddedAtSelection.

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	msctf.h
DLL	Msctf.dll
Verteilbare Komponente	TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

Idataobject

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection