Skip to content

Latest commit

 

History

History
195 lines (147 loc) · 5.62 KB

nf-msctf-itfinsertatselection-insertembeddedatselection.md

File metadata and controls

195 lines (147 loc) · 5.62 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:msctf.ITfInsertAtSelection.InsertEmbeddedAtSelection
ITfInsertAtSelection::InsertEmbeddedAtSelection (msctf.h)
The ITfInsertAtSelection::InsertEmbeddedAtSelection method inserts an IDataObject object at the selection or insertion point.
ITfInsertAtSelection interface [Text Services Framework]
InsertEmbeddedAtSelection method
ITfInsertAtSelection.InsertEmbeddedAtSelection
ITfInsertAtSelection::InsertEmbeddedAtSelection
InsertEmbeddedAtSelection
InsertEmbeddedAtSelection method [Text Services Framework]
InsertEmbeddedAtSelection method [Text Services Framework]
ITfInsertAtSelection interface
_tsf_itfinsertatselection_insertembeddedatselection_ref
msctf/ITfInsertAtSelection::InsertEmbeddedAtSelection
tsf.itfinsertatselection_insertembeddedatselection
tsf\itfinsertatselection_insertembeddedatselection.htm
TSF
13fa9955-0087-4dd9-8a1d-814ab801e956
12/05/2018
ITfInsertAtSelection interface [Text Services Framework],InsertEmbeddedAtSelection method, ITfInsertAtSelection.InsertEmbeddedAtSelection, ITfInsertAtSelection::InsertEmbeddedAtSelection, InsertEmbeddedAtSelection, InsertEmbeddedAtSelection method [Text Services Framework], InsertEmbeddedAtSelection method [Text Services Framework],ITfInsertAtSelection interface, _tsf_itfinsertatselection_insertembeddedatselection_ref, msctf/ITfInsertAtSelection::InsertEmbeddedAtSelection, tsf.itfinsertatselection_insertembeddedatselection
msctf.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Msctf.idl
Msctf.dll
Windows
TSF 1.0 on Windows 2000 Professional
19H1
ITfInsertAtSelection::InsertEmbeddedAtSelection
msctf/ITfInsertAtSelection::InsertEmbeddedAtSelection
c++
APIRef
kbSyntax
COM
msctf.dll
ITfInsertAtSelection.InsertEmbeddedAtSelection

ITfInsertAtSelection::InsertEmbeddedAtSelection

-description

The ITfInsertAtSelection::InsertEmbeddedAtSelection method inserts an IDataObject object at the selection or insertion point.

-parameters

-param ec [in]

Identifies the edit context. This is obtained from ITfDocumentMgr::CreateContext or ITfEditSession::DoEditSession.

-param dwFlags [in]

Bit field with one of the following values:

TF_IAS_NOQUERY

The ppRange parameter is NULL on exit.

TF_IAS_QUERYONLY

Context is not modified but the ppRange parameter is set as if the insert occurred. Read-only access is sufficient. If this flag is not set, the ec parameter must have read/write access.

TF_IAS_NO_DEFAULT_COMPOSITION

The TSF manager does not create a default composition if a composition is required. The caller must create a composition object that covers the inserted text before releasing the context lock.

-param pDataObject [in]

Pointer to object to insert.

-param ppRange [out]

Position of the inserted object. Optional.

-returns

This method can return one of these values.

Value Description
S_OK
The method was successful.
TF_E_NOLOCK
The ec parameter is an invalid edit cookie.
TF_E_DISCONNECTED
Context object is not on a document stack.
TS_E_NOSELECTION
Context has no selection.
TS_E_READONLY
Selection is read-only.
TF_E_FORMAT
Context owner cannot handle objects of the type provided by the pDataObject parameter.

-remarks

Callers can use the ITfQueryEmbedded::QueryInsertEmbedded method to determine if a particular object type is likely to be accepted by this method.

To insert text instead of an IDataObject object, use the ITfInsertAtSelection::InsertTextAtSelection method.

-see-also

IDataObject

ITfDocumentMgr::CreateContext

ITfEditSession::DoEditSession

ITfInsertAtSelection

ITfInsertAtSelection::InsertTextAtSelection

ITfQueryEmbedded::QueryInsertEmbedded