Metode ITfDocumentMgr::P op (msctf.h)

Artikel
08/03/2023

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
S_OK	Metode berhasil.
E_FAIL	Tumpukan kosong atau metode ini dipanggil tanpa bendera TF_POPF_ALL dan hanya satu konteks yang ada di tumpukan.
E_UNEXPECTED	Metode ini dipanggil selama panggilan ITfDocumentMgr::P op lainnya.
E_INVALIDARG	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