iTfDocumentMgr::P op 方法 (msctf.h)

從內容堆疊頂端移除內容。

語法

HRESULT Pop(
  [in] DWORD dwFlags
);

參數

[in] dwFlags

如果此值為 0,則只會移除堆疊頂端的內容。 如果此值TF_POPF_ALL,則會從堆疊中移除所有內容。

傳回值

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

描述
S_OK
此方法成功。
E_FAIL
堆疊是空的,或者這個方法在沒有TF_POPF_ALL旗標的情況下呼叫,而且只有單一內容位於堆疊上。
E_UNEXPECTED
這個方法是在另一個 ITfDocumentMgr::P op 呼叫期間呼叫。
E_INVALIDARG
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

另請參閱

ITfDocumentMgr

ITfDocumentMgr::P ush

ITfThreadMgrEventSink::OnPopCoNtext

ITfThreadMgrEventSink::OnUninitDocumentMgr