Metode ITfDocumentMgr::P ush (msctf.h)
Menambahkan konteks ke bagian atas tumpukan konteks.
Sintaks
HRESULT Push(
[in] ITfContext *pic
);
Parameter
[in] pic
Penunjuk ke objek ITfContext yang akan ditambahkan ke tumpukan. Objek ini diperoleh dari panggilan sebelumnya ke ITfDocumentMgr::CreateContext.
Nilai kembali
Metode ini dapat mengembalikan salah satu nilai ini.
| Nilai | Deskripsi |
|---|---|
|
Metode berhasil. |
|
pic tidak valid. |
|
Tidak ada ruang pada tumpukan untuk konteks. Tumpukan konteks memiliki batas dua konteks. |
|
Metode ini dipanggil selama panggilan ITfDocumentMgr::P op . |
Keterangan
Konteks pertama yang ditambahkan ke tumpukan menjadi konteks dokumen utama.
Manajer TSF dan layanan teks hanya berinteraksi dengan konteks di bagian atas tumpukan. Biasanya, hanya konteks dokumen utama yang ada di tumpukan. Terkadang, perlu untuk menambahkan konteks kedua ke tumpukan. Misalnya, saat layanan teks harus menampilkan UI modal, seperti daftar kandidat. Selama waktu ini, layanan teks akan menambahkan konteksnya ke tumpukan. Ketika UI layanan teks tidak lagi diperlukan, layanan teks akan menghapus konteks dari tumpukan. Konteks utama kemudian kembali ke bagian atas tumpukan. Untuk menyederhanakan proses ini dan mencegah beberapa UI modal ditampilkan, ada maksimal dua konteks yang diizinkan pada tumpukan.
Metode ini menyebabkan metode ITfThreadMgrEventSink::OnPushContext dari semua sink peristiwa manajer utas yang diinstal dipanggil. Jika ini adalah konteks pertama yang ditambahkan ke tumpukan, metode ini menyebabkan metode ITfThreadMgrEventSink::OnInitDocumentMgr dari semua sink peristiwa pengelola utas yang diinstal dipanggil.
ITfDocumentMgr::P op harus dipanggil untuk menghapus konteks ini dari tumpukan konteks.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |