ITfInsertAtSelection::InsertEmbeddedAtSelection-Methode (msctf.h)

Die ITfInsertAtSelection::InsertEmbeddedAtSelection-Methode fügt ein IDataObject-Objekt an der Auswahl- oder Einfügemarke ein.

Syntax

HRESULT InsertEmbeddedAtSelection(
  [in]  TfEditCookie ec,
  [in]  DWORD        dwFlags,
  [in]  IDataObject  *pDataObject,
  [out] ITfRange     **ppRange
);

Parameter

[in] ec

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

[in] dwFlags

Bitfeld mit einem der folgenden Werte:

TF_IAS_NOQUERY

Der ppRange-Parameter ist beim Beenden NULL .

TF_IAS_QUERYONLY

Der Kontext wird nicht geändert, aber der ppRange-Parameter wird so festgelegt, als ob der Einfügevorgang erfolgt wäre. Schreibgeschützter Zugriff ist ausreichend. Wenn dieses Flag nicht festgelegt ist, muss der ec-Parameter Über Lese-/Schreibzugriff verfügen.

TF_IAS_NO_DEFAULT_COMPOSITION

Der TSF-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] pDataObject

Zeiger auf das einzufügende Objekt.

[out] ppRange

Position des eingefügten Objekts. Optional.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
TF_E_NOLOCK	Der ec-Parameter ist ein ungültiges Bearbeitungscookies.
TF_E_DISCONNECTED	Das Context-Objekt befindet sich nicht in einem Dokumentstapel.
TS_E_NOSELECTION	Der Kontext hat keine Auswahl.
TS_E_READONLY	Die Auswahl ist schreibgeschützt.
TF_E_FORMAT	Der Kontextbesitzer kann keine Objekte des Typs verarbeiten, der vom pDataObject-Parameter bereitgestellt wird.

Hinweise

Aufrufer können die ITfQueryEmbedded::QueryInsertEmbedded-Methode verwenden, um zu bestimmen, ob ein bestimmter Objekttyp wahrscheinlich von dieser Methode akzeptiert wird.

Um Text anstelle eines IDataObject-Objekts einzufügen, verwenden Sie die ITfInsertAtSelection::InsertTextAtSelection-Methode .

Anforderungen

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::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded