Fungsi AllowSetForegroundWindow (winuser.h)
Memungkinkan proses yang ditentukan untuk mengatur jendela latar depan menggunakan fungsi SetForegroundWindow . Proses panggilan harus sudah dapat mengatur jendela latar depan. Untuk informasi selengkapnya, lihat Keterangan nanti dalam topik ini.
Sintaks
BOOL AllowSetForegroundWindow(
[in] DWORD dwProcessId
);
Parameter
[in] dwProcessId
Jenis: DWORD
Pengidentifikasi proses yang akan diaktifkan untuk mengatur jendela latar depan. Jika parameter ini ASFW_ANY, semua proses akan diaktifkan untuk mengatur jendela latar depan.
Nilai kembali
Jenis: BOOL
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Fungsi akan gagal jika proses panggilan tidak dapat mengatur jendela latar depan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Sistem membatasi proses mana yang dapat mengatur jendela latar depan. Biasanya, proses dapat mengatur jendela latar depan dengan memanggil fungsi SetForegroundWindow hanya jika:
- Semua kondisi berikut ini benar:
- Proses panggilan milik aplikasi desktop, bukan aplikasi UWP atau aplikasi Windows Store yang dirancang untuk Windows 8 atau 8.1.
- Proses latar depan belum menonaktifkan panggilan ke SetForegroundWindow dengan panggilan sebelumnya ke fungsi LockSetForegroundWindow .
- Batas waktu kunci latar depan telah kedaluwarsa (lihat SPI_GETFOREGROUNDLOCKTIMEOUT di SystemParametersInfo).
- Tidak ada menu yang aktif.
- Selain itu, setidaknya salah satu kondisi berikut ini benar:
- Proses panggilan adalah proses latar depan.
- Proses panggilan dimulai oleh proses latar depan.
- Saat ini tidak ada jendela latar depan, dan dengan demikian tidak ada proses latar depan.
- Proses panggilan menerima peristiwa input terakhir.
- Baik proses latar depan atau proses panggilan sedang di-debug.
Proses yang dapat mengatur jendela latar depan dapat mengaktifkan proses lain untuk mengatur jendela latar depan dengan memanggil AllowSetForegroundWindow. Proses yang ditentukan oleh parameter dwProcessId kehilangan kemampuan untuk mengatur jendela latar depan lain kali pengguna menghasilkan input, kecuali input diarahkan pada proses tersebut, atau kali berikutnya proses memanggil AllowSetForegroundWindow, kecuali proses yang sama ditentukan seperti dalam panggilan sebelumnya ke AllowSetForegroundWindow.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winuser.h (sertakan Windows.h) |
| Pustaka | User32.lib |
| DLL | User32.dll |
| Set API | ext-ms-win-ntuser-window-l1-1-0 (diperkenalkan dalam Windows 8) |
Lihat juga
Konseptual
Referensi