iTfDocumentMgr::P op 方法 (msctf.h)
從內容堆疊頂端移除內容。
語法
HRESULT Pop(
[in] DWORD dwFlags
);
參數
[in] dwFlags
如果此值為 0,則只會移除堆疊頂端的內容。 如果此值TF_POPF_ALL,則會從堆疊中移除所有內容。
傳回值
這個方法可以傳回其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
堆疊是空的,或者這個方法在沒有TF_POPF_ALL旗標的情況下呼叫,而且只有單一內容位於堆疊上。 |
|
這個方法是在另一個 ITfDocumentMgr::P op 呼叫期間呼叫。 |
|
dwFlags 無效。 |
備註
這個方法必須從與對應的 ITfDocumentMgr::P ush 呼叫相同的執行緒呼叫。
新增至堆疊的第一個內容會成為主要內容。 沒有使用 TF_POPF_ALL 旗標,就無法從堆疊中移除主要內容。 當檔未初始化時,應該使用 TF_POPF_ALL 旗標呼叫此方法。 這會導致檔管理員從內容堆疊移除所有內容,並終止任何文字服務 UI。 請勿在任何其他時間使用 TF_POPF_ALL 旗標。
這個方法會導致呼叫所有已安裝執行緒管理員事件接收的 ITfThreadMgrEventSink::OnPopCoNtext 方法。 如果最後一個內容從堆疊中移除,這個方法會導致呼叫所有已安裝執行緒管理員事件接收器的 ITfThreadMgrEventSink::OnUninitDocumentMgr 方法。
需求
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |