Metode ITfDocumentMgr::P op (msctf.h)
Menghapus konteks dari bagian atas tumpukan konteks.
Sintaks
HRESULT Pop(
[in] DWORD dwFlags
);
Parameter
[in] dwFlags
Jika nilai ini adalah 0, hanya konteks di bagian atas tumpukan yang dihapus. Jika nilai ini TF_POPF_ALL, semua konteks dihapus dari tumpukan.
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
| Nilai | Deskripsi |
|---|---|
|
Metode berhasil. |
|
Tumpukan kosong atau metode ini dipanggil tanpa bendera TF_POPF_ALL dan hanya satu konteks yang ada di tumpukan. |
|
Metode ini dipanggil selama panggilan ITfDocumentMgr::P op lainnya. |
|
dwFlags tidak valid. |
Keterangan
Metode ini harus dipanggil dari utas yang sama dengan panggilan ITfDocumentMgr::P ush yang sesuai.
Konteks pertama yang ditambahkan ke tumpukan menjadi konteks utama. Konteks utama tidak dapat dihapus dari tumpukan tanpa menggunakan bendera TF_POPF_ALL. Ketika dokumen tidak diinisialisasi, metode ini harus dipanggil dengan bendera TF_POPF_ALL. Hal ini menyebabkan manajer dokumen menghapus semua konteks dari tumpukan konteks dan mengakhiri UI layanan teks apa pun. Jangan gunakan bendera TF_POPF_ALL di lain waktu.
Metode ini menyebabkan metode ITfThreadMgrEventSink::OnPopContext dari semua sink peristiwa manajer utas yang diinstal dipanggil. Jika konteks terakhir dihapus dari tumpukan, metode ini menyebabkan metode ITfThreadMgrEventSink::OnUninitDocumentMgr dari semua sink peristiwa manajer utas yang diinstal dipanggil.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | msctf.h |
| DLL | Msctf.dll |
| Redistribusi | TSF 1.0 di Windows 2000 Professional |