iTfInsertAtSelection：：InsertEmbeddedAtSelection 方法 (msctf.h)
ITfInsertAtSelection：：InsertEmbeddedAtSelection方法會在選取或插入點插入IDataObject物件。
語法
HRESULT InsertEmbeddedAtSelection(
[in] TfEditCookie ec,
[in] DWORD dwFlags,
[in] IDataObject *pDataObject,
[out] ITfRange **ppRange
);
參數
[in] ec
識別編輯內容。 這是從 ITfDocumentMgr：：CreateCoNtext 或 ITfEditSession：:D oEditSession取得。
[in] dwFlags
具有下列其中一個值的位欄位：
TF_IAS_NOQUERY
ppRange參數在結束時為Null。
TF_IAS_QUERYONLY
不會修改內容，但會設定 ppRange 參數，就像發生插入一樣。 唯讀存取已足夠。 如果未設定此旗標， ec 參數必須具有讀取/寫入權限。
TF_IAS_NO_DEFAULT_COMPOSITION
如果需要組合，TSF 管理員不會建立預設組合。 呼叫端必須建立一個組合物件，該物件涵蓋插入的文字，再釋放內容鎖定。
[in] pDataObject
要插入之物件的指標。
[out] ppRange
插入物件的位置。 選擇性。
傳回值
這個方法可以傳回下列其中一個值。
| 值 | 描述 |
|---|---|
|
此方法成功。 |
|
ec參數是不正確編輯 Cookie。 |
|
內容物件不在檔堆疊上。 |
|
內容沒有選取範圍。 |
|
選取範圍是唯讀的。 |
|
內容擁有者無法處理 pDataObject 參數所提供的類型物件。 |
備註
呼叫端可以使用 ITfQueryEmbedded：：QueryInsertEmbedded 方法來判斷這個方法是否可能接受特定物件類型。
若要插入文字而非 IDataObject 物件，請使用 ITfInsertAtSelection：：InsertTextAtSelection 方法。
需求
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | msctf.h |
| Dll | Msctf.dll |
| 可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |
另請參閱
ITfEditSession：:D oEditSession