ITextStoreACP::InsertEmbedded method (textstor.h)

Inserts an embedded object at the specified character.

Syntax

HRESULT InsertEmbedded(
  [in]  DWORD         dwFlags,
  [in]  LONG          acpStart,
  [in]  LONG          acpEnd,
  [in]  IDataObject   *pDataObject,
  [out] TS_TEXTCHANGE *pChange
);

Parameters

[in] dwFlags

Must be TS_IE_CORRECTION.

[in] acpStart

Contains the starting character position where the object is inserted.

[in] acpEnd

Contains the ending character position where the object is inserted.

[in] pDataObject

Pointer to an IDataObject interface that contains data about the object inserted.

[out] pChange

Pointer to a TS_TEXTCHANGE structure that receives data about the modified text.

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.
E_INVALIDARG
One or more parameters are invalid.
E_NOTIMPL
The application does not support embedded objects.
TS_E_FORMAT
The application does not support the data type contained in pDataObject.
TS_E_INVALIDPOS
acpStart and/or acpEnd are not within the document.
TS_E_NOLOCK
The caller does not have a read/write lock.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header textstor.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

IDataObject

ITextStoreACP

TS_IE_* Constants

TS_TEXTCHANGE