ITfRange::InsertEmbedded-Methode (msctf.h)

Artikel
08/24/2023

Die ITfRange::InsertEmbedded-Methode fügt ein Objekt an der Position des Startankers des Textbereichs ein.

Syntax

HRESULT InsertEmbedded(
  [in] TfEditCookie ec,
  [in] DWORD        dwFlags,
  [in] IDataObject  *pDataObject
);

Parameter

[in] ec

Bearbeiten Sie das cookie, das von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen wurde.

[in] dwFlags

Bitfelder, die angeben, wie das Einfügen erfolgen soll. Wenn TF_IE_CORRECTION festgelegt ist, ist der Vorgang eine Korrektur, sodass andere Textdienste Daten beibehalten können, die dem ursprünglichen Text zugeordnet sind.

[in] pDataObject

Zeiger auf das einzufügende Datenübertragungsobjekt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_NOTIMPL	Die implementierenden Anwendungen machen keine eingebetteten Objekte in ihrem Stream verfügbar.
TF_E_COMPOSITION_REJECTED	Der Kontextbesitzer hat eine Standardkomposition abgelehnt.
TF_E_FORMAT	Der Kontextbesitzer kann den angegebenen Objekttyp nicht verarbeiten.
TF_E_NOLOCK	Der Wert des ec-Parameters ist ein ungültiges Cookie, oder der Aufrufer verfügt nicht über eine schreibgeschützte Sperre.
TF_E_RANGE_NOT_COVERED	Der Aufrufer verfügt bereits über eine aktive Komposition, aber der Bereich wird über Text positioniert, der nicht von der Komposition abgedeckt ist.
TF_E_READONLY	Das Dokument oder die Position des Bereichs kann nicht geändert werden.

Hinweise

Verwenden Sie diese Methode, um Objekte in den Textstream einzufügen, da das TF_CHAR_EMBEDDED Objektplatzhalterzeichen nicht an ITfRange::SetText übergeben werden kann. Diese Methode wird nach der OLE-Zwischenablage-API modelliert, wobei Anwendungen pDataObject wie ein von OleGetClipboard zurückgegebenes IDataObject verwenden.

Wenn ein Bereich mehrere Regionen abdeckt, sollte die Methode für jede Region separat aufgerufen werden. Andernfalls schlägt die Methode möglicherweise fehl.

Standardmäßig starten und beenden Textdienste eine temporäre Komposition, die den Bereich abdeckt, um sicherzustellen, dass Kontextbesitzer Kompositionen über bearbeiteten Text konsistent erkennen. Wenn der Kompositionsbesitzer eine Standardkomposition ablehnt, gibt die Methode TF_E_COMPOSITION_REJECTED zurück. Standardkompositionen werden nur erstellt, wenn der Aufrufer noch keine gestartet hat. Wenn der Aufrufer über eine aktive Komposition verfügt, schlägt der Aufruf fehl.

Verwenden Sie ITfQueryEmbedded::QueryInsertEmbedded, um im Voraus zu bestimmen, ob ein Kontextbesitzer das Einfügen eines bestimmten Objekts unterstützt.

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