Funzione LockWindowUpdate (winuser.h)

Articolo
03/13/2024

La funzione LockWindowUpdate disabilita o abilita il disegno nella finestra specificata. È possibile bloccare una sola finestra alla volta.

Sintassi

BOOL LockWindowUpdate(
  [in] HWND hWndLock
);

Parametri

[in] hWndLock

Finestra in cui verrà disabilitato il disegno. Se questo parametro è NULL, il disegno nella finestra bloccata è abilitato.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero, a indicare che si è verificato un errore o che è già stata bloccata un'altra finestra.

Commenti

Lo scopo della funzione LockWindowUpdate è consentire il disegno del feedback di trascinamento della selezione su una finestra senza interferenze dalla finestra stessa. La finalità è che la finestra viene bloccata quando il feedback viene disegnato e sbloccato al termine del feedback. LockWindowUpdate non è destinato all'eliminazione per utilizzo generico della nuova finestra. Usare il messaggio di WM_SETREDRAW per disabilitare il ridisegno di una finestra specifica.

Se un'applicazione con una finestra bloccata (o qualsiasi finestra figlio bloccata) chiama la funzione GetDC, GetDCEx o BeginPaint , la funzione chiamata restituisce un contesto di dispositivo con un'area visibile vuota. Ciò si verifica fino a quando l'applicazione non sblocca la finestra chiamando LockWindowUpdate, specificando un valore NULL per hWndLock.

Se un'applicazione tenta di disegnare all'interno di una finestra bloccata, il sistema registra l'estensione dell'operazione tentata in un rettangolo di delimitazione. Quando la finestra viene sbloccata, il sistema invalida l'area all'interno di questo rettangolo di delimitazione, forzando un messaggio di WM_PAINT finale da inviare alla finestra bloccata in precedenza e alle finestre figlio. Se non si è verificato alcun disegno durante l'aggiornamento della finestra, non viene invalidata alcuna area.

LockWindowUpdate non rende invisibile la finestra specificata e non cancella il bit di stile WS_VISIBLE.

Non è possibile spostare una finestra bloccata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-2 (introdotto in Windows 10 versione 10.0.10240)