ITfContextOwnerCompositionServices::TerminateComposition 方法 (msctf.h)
終止組合。
語法
HRESULT TerminateComposition(
[in] ITfCompositionView *pComposition
);
參數
[in] pComposition
代表要終止之組合的 ITfCompositionView 介面指標。 如果此值為 NULL,內容中的所有組合都會終止。
傳回值
這個方法可以傳回其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
內容不在檔堆疊上。 |
|
文字服務目前在檔上保留鎖定。 |
|
這個方法是在另一個組合作業期間呼叫。 |
|
發生未指定的錯誤。 |
備註
文字服務會使用 ITfComposition::EndComposition 來終止它所建立的組合。
如果內容擁有者實作文字存放區,內容擁有者必須先授與同步寫入鎖定,才能呼叫此方法。
此方法也會執行下列動作:
- 針對終止的每個組合,會針對所有已安裝的組合建議接收呼叫 ITfCompositionSink::OnCompositionTerminated 。
- 如果內容擁有者已安裝內容擁有者組合建議接收,則會針對每個終止的組合呼叫 ITfContextOwnerCompositionSink::OnEndComposition 。
- 系統會清除每個終止組合所涵蓋文字的GUID_PROP_COMPOSING屬性。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |
另請參閱
ITfComposition::EndComposition、 nf-msctf-itfcompositionsink-oncompositionterminated、 ITfCompositionView 介面、 ITfContextOwnerCompositionServices 介面、 ITfContextOwnerCompositionSink::OnEndComposition