Freigeben über

ITextStoreAnchor::InsertEmbeddedAtSelection-Methode (textstor.h)

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.

[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

Weitere Informationen

Idataobject

ITextStoreAnchor

ITextStoreAnchor::QueryInsertEmbedded

ITextStoreAnchor::SetText

TF_IAS_*-Konstanten

TS_CHAR_EMBEDDED

  • Last updated on