ITfDocumentMgr：:P ush 方法 (msctf.h)
將內容新增至內容堆疊頂端。
語法
HRESULT Push(
[in] ITfContext *pic
);
參數
[in] pic
要加入堆疊之 ITfContext 物件的指標。 這個物件是從先前呼叫 ITfDocumentMgr：：CreateContext 取得。
傳回值
這個方法可以傳回其中一個值。
| 值 | 描述 |
|---|---|
|
此方法成功。 |
|
pic 無效。 |
|
內容堆疊上沒有空間。 內容堆疊有兩個內容的限制。 |
|
這個方法是在 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 |