Bagikan melalui


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

LockSetForegroundWindow

Referensi

SetForegroundWindow

Windows