共用方式為


ITfDocumentMgr::P ush 方法 (msctf.h)

將內容新增至內容堆疊頂端。

語法

HRESULT Push(
  [in] ITfContext *pic
);

參數

[in] pic

要加入堆疊之 ITfContext 物件的指標。 這個物件是從先前呼叫 ITfDocumentMgr::CreateContext 取得。

傳回值

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

描述
S_OK
此方法成功。
E_INVALIDARG
pic 無效。
TF_E_STACKFULL
內容堆疊上沒有空間。 內容堆疊有兩個內容的限制。
E_UNEXPECTED
這個方法是在 ITfDocumentMgr::P op 呼叫期間呼叫。

備註

新增至堆疊的第一個內容會成為主要文件內容。

TSF 管理員和文字服務只會與堆疊頂端的內容互動。 一般而言,只有主要文件內容位於堆疊上。 有時候,必須將第二個內容新增至堆疊。 例如,當文字服務必須顯示強制回應UI時,例如候選清單。 在此期間,文字服務會將其內容新增至堆疊。 不再需要文字服務 UI 時,文字服務會從堆疊中移除內容。 然後主要內容會返回堆疊頂端。 為了簡化此程式,並防止顯示多個強制回應 UI,堆疊上最多允許兩個內容。

這個方法會導致呼叫所有已安裝線程管理員事件接收器的 ITfThreadMgrEventSink::OnPushContext 方法。 如果這是要新增至堆棧的第一個內容,這個方法會導致呼叫所有已安裝線程管理員事件接收器的 ITfThreadMgrEventSink::OnInitDocumentMgr 方法。

必須呼叫 ITfDocumentMgr::P op,才能從內容堆疊中移除此內容。

規格需求

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

另請參閱

ITfContext

ITfDocumentMgr

ITfDocumentMgr::CreateContext

ITfDocumentMgr::P op

ITfThreadMgrEventSink::OnInitDocumentMgr

ITfThreadMgrEventSink::OnPushContext