LockWindowUpdate 함수(winuser.h)

아티클
08/27/2023

LockWindowUpdate 함수는 지정된 창에서 그리기를 사용하지 않도록 설정하거나 사용하도록 설정합니다. 한 번에 하나의 창만 잠글 수 있습니다.

구문

BOOL LockWindowUpdate(
  [in] HWND hWndLock
);

매개 변수

[in] hWndLock

그리기를 사용하지 않도록 설정할 창입니다. 이 매개 변수가 NULL이면 잠긴 창에서 그리기를 사용할 수 있습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값이 0이 되며 오류가 발생했거나 다른 창이 이미 잠겨 있음을 나타냅니다.

설명

LockWindowUpdate 함수의 목적은 창 자체의 간섭 없이 창 위에 끌어서 놓기 피드백을 그릴 수 있도록 하는 것입니다. 피드백이 완료될 때 피드백이 그려지고 잠금이 해제될 때 창이 잠기는 것이 목적입니다. LockWindowUpdate 는 창 다시 그리기를 범용으로 표시하지 않습니다. WM_SETREDRAW 메시지를 사용하여 특정 창의 다시 그리기를 사용하지 않도록 설정합니다.

잠긴 창(또는 잠긴 자식 창)이 있는 애플리케이션이 GetDC, GetDCEx 또는 BeginPaint 함수를 호출하는 경우 호출된 함수는 비어 있는 표시되는 영역이 있는 디바이스 컨텍스트를 반환합니다. 이는 애플리케이션이 LockWindowUpdate를 호출하고 hWndLock에 대해 NULL 값을 지정하여 창의 잠금을 해제할 때까지 발생합니다.

애플리케이션이 잠긴 창 내에서 그리려고 하면 시스템은 시도된 작업의 범위를 경계 사각형에 기록합니다. 창의 잠금이 해제되면 시스템에서 이 경계 사각형 내의 영역을 무효화하여 최종 WM_PAINT 메시지를 이전에 잠긴 창과 해당 자식 창으로 보내도록 합니다. 창 업데이트가 잠긴 동안 드로잉이 발생하지 않으면 영역이 무효화되지 않습니다.

LockWindowUpdate 는 지정된 창을 표시하지 않으며 WS_VISIBLE 스타일 비트를 지우지 않습니다.

잠긴 창을 이동할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	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에 도입됨)