LockWindowUpdate 函式 (winuser.h)

發行項
03/09/2024

LockWindowUpdate 函式會停用或啟用指定視窗中的繪圖。一次只能鎖定一個視窗。

語法

BOOL LockWindowUpdate(
  [in] HWND hWndLock
);

參數

[in] hWndLock

將停用繪圖的視窗。如果此參數為 NULL，則會啟用鎖定視窗中的繪圖。

傳回值

如果函式成功，則傳回非零的值。

如果函式失敗，則傳回值為零，表示發生錯誤或已鎖定另一個視窗。

備註

LockWindowUpdate 函式的目的是允許在視窗上繪製拖放意見反應，而不會干擾視窗本身。意圖是，在繪製意見反應時鎖定視窗，並在意見反應完成時解除鎖定。 LockWindowUpdate 不適用於視窗重繪的一般用途隱藏。使用 WM_SETREDRAW 訊息來停用重新繪製特定視窗。

如果具有鎖定視窗的應用程式 (或任何鎖定的子視窗) 呼叫 GetDC、 GetDCEx 或 BeginPaint 函式，則呼叫的函式會傳回具有空白之可見區域的裝置內容。這會在應用程式呼叫 LockWindowUpdate 以解除鎖定視窗之前發生，並指定 hWndLock 的 NULL 值。

如果應用程式嘗試在鎖定的視窗中繪製，系統會在周框內記錄嘗試作業的範圍。當視窗解除鎖定時，系統會使這個周框內的區域失效，強制最終 WM_PAINT 訊息傳送至先前鎖定的視窗及其子視窗。如果視窗更新鎖定時未發生繪圖，則不會有任何區域失效。

LockWindowUpdate 不會讓指定的視窗不可見，也不會清除WS_VISIBLE樣式位。

無法移動鎖定的視窗。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-draw-l1-1-2 (於 Windows 10 10.0.10240 版)