Fungsi LockWindowUpdate (winuser.h)

Artikel
03/04/2024

Fungsi LockWindowUpdate menonaktifkan atau mengaktifkan gambar di jendela yang ditentukan. Hanya satu jendela yang dapat dikunci pada satu waktu.

Sintaks

BOOL LockWindowUpdate(
  [in] HWND hWndLock
);

Parameter

[in] hWndLock

Jendela tempat gambar akan dinonaktifkan. Jika parameter ini NULL, menggambar di jendela terkunci diaktifkan.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol, menunjukkan bahwa terjadi kesalahan atau jendela lain sudah dikunci.

Keterangan

Tujuan dari fungsi LockWindowUpdate adalah untuk mengizinkan umpan balik seret/letakkan untuk digambar di atas jendela tanpa gangguan dari jendela itu sendiri. Tujuannya adalah bahwa jendela dikunci ketika umpan balik digambar dan dibuka ketika umpan balik selesai. LockWindowUpdate tidak ditujukan untuk penekanan tujuan umum dari penguraian ulang jendela. Gunakan pesan WM_SETREDRAW untuk menonaktifkan penggalian ulang jendela tertentu.

Jika aplikasi dengan jendela terkunci (atau jendela anak terkunci) memanggil fungsi GetDC, GetDCEx, atau BeginPaint , fungsi yang disebut mengembalikan konteks perangkat dengan wilayah yang terlihat kosong. Ini akan terjadi sampai aplikasi membuka kunci jendela dengan memanggil LockWindowUpdate, menentukan nilai NULL untuk hWndLock.

Jika aplikasi mencoba menggambar dalam jendela terkunci, sistem merekam sejauh mana operasi yang dicoba dalam persegi panjang pembatas. Ketika jendela tidak terkunci, sistem membatalkan area dalam persegi panjang pembatas ini, memaksa pesan WM_PAINT akhirnya dikirim ke jendela yang dikunci sebelumnya dan jendela anaknya. Jika tidak ada gambar yang terjadi saat pembaruan jendela dikunci, tidak ada area yang tidak valid.

LockWindowUpdate tidak membuat jendela yang ditentukan tidak terlihat dan tidak menghapus bit gaya WS_VISIBLE.

Jendela terkunci tidak dapat dipindahkan.

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-draw-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.10240)