iTfCoNtextComposition：：StartComposition 方法 (msctf.h)

建立新的組合。

語法

HRESULT StartComposition(
  [in]  TfEditCookie       ecWrite,
  [in]  ITfRange           *pCompositionRange,
  [in]  ITfCompositionSink *pSink,
  [out] ITfComposition     **ppComposition
);

參數

[in] ecWrite

包含可識別編輯內容的編輯 Cookie。 這是從 ITfEditSession：:D oEditSession取得。

[in] pCompositionRange

ITfRange物件的指標，指定撰寫一開始涵蓋的文字。

[in] pSink

接收組合事件通知之 ITfCompositionSink 物件的指標。 此參數是選擇性的，可以是 Null。 如果提供，當組合終止時，物件就會釋放。

[out] ppComposition

接收新組合物件的 ITfComposition 介面指標指標。 如果內容擁有者拒絕組合，此參數就會收到 Null 。

傳回值

這個方法可以傳回其中一個值。

值	描述
S_OK	此方法成功。 如果內容擁有者組合建議接收拒絕組合， ppComposition 會設定為 Null。
E_FAIL	發生未指定的錯誤。
E_INVALIDARG	一或多個參數無效。
E_OUTOFMEMORY	無法建立組合物件。
E_UNEXPECTED	方法是在另一個組合作業內呼叫。
TF_E_DISCONNECTED	內容物件不在檔堆疊上。
TF_E_NOLOCK	ecWrite所識別的編輯內容沒有讀取/寫入鎖定。

備註

如果內容擁有者已安裝內容擁有者組合建議接收，則會呼叫 ITfCoNtextOwnerCompositionSink：：OnStartComposition 方法。 如果建議接收拒絕新的組合，這個方法會傳回S_OK，但 ppComposition 會設定為 Null。

pCompositionRange所涵蓋的任何文字都會收到 GUID_PROP_COMPOSING 屬性。

需求

最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0

另請參閱

IEnumITfCompositionView 介面、 ITfCoNtextComposition 介面、 ITfRange 介面、 ITfCompositionSink 介面、 ITfCoNtextOwnerCompositionSink：：OnStartComposition、 ITfEditSession：:D oEditSession