共用方式為

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