ITextStoreAnchor::InsertEmbeddedAtSelection-Methode (textstor.h)

Artikel
03/02/2024

Die ITextStoreAnchor::InsertEmbeddedAtSelection-Methode fügt ein IDataObject-Objekt an der Einfügemarke oder Auswahl ein. Der Client, der diese Methode aufruft, muss über eine Lese-/Schreibsperre verfügen, bevor ein IDataObject in den Textstream eingefügt wird.

Syntax

HRESULT InsertEmbeddedAtSelection(
  [in]  DWORD       dwFlags,
  [in]  IDataObject *pDataObject,
  [out] IAnchor     **ppaStart,
  [out] IAnchor     **ppaEnd
);

Parameter

[in] dwFlags

Gibt an, ob die Parameter paStart und paEnd die Ergebnisse der Objekteinfü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, z. B. um die Ergebnisse des Zusammenbrechens oder anderweitigen Anpassens einer Auswahl vorherzusagen.

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, z. B. um die Ergebnisse des Zusammenbrechens oder anderweitigen Anpassens einer Auswahl vorherzusagen.

[in] pDataObject

Zeiger auf das IDataObject-Objekt , das eingefügt werden soll.

[out] ppaStart

Zeiger auf das Ankerobjekt am Anfang des Objekteinfügungs.

[out] ppaEnd

Zeiger auf das Ankerobjekt am Ende des Objekteinfügungs. 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.
E_OUTOFMEMORY	Die Methode konnte keinen der Anker paStart oder paEnd instanziieren.
TS_E_NOLOCK	Der Aufrufer verfügt nicht über eine Sperre für das Dokument.

Hinweise

Clients müssen diese Methode verwenden, um ein Objekt in einen Textstream einzufügen, da eine TS_CHAR_EMBEDDED Konstante nicht an ITextStoreAnchor::SetText übergeben werden kann.

Anforderungen

Anforderung	Wert
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