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

發行項
02/29/2024

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

語法

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