BeginPaint 함수(winuser.h)

아티클
03/04/2024

BeginPaint 함수는 그리기 위해 지정된 창을 준비하고 그림에 대한 정보로 PAINTSTRUCT 구조를 채웁니다.

구문

HDC BeginPaint(
  [in]  HWND          hWnd,
  [out] LPPAINTSTRUCT lpPaint
);

매개 변수

[in] hWnd

다시 칠할 창에 대한 핸들입니다.

[out] lpPaint

그리기 정보를 받을 PAINTSTRUCT 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 지정된 창에 대한 디스플레이 디바이스 컨텍스트에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL로, 디스플레이 디바이스 컨텍스트를 사용할 수 없음을 나타냅니다.

설명

BeginPaint 함수는 업데이트 영역 외부의 모든 영역을 제외하도록 디바이스 컨텍스트의 클리핑 영역을 자동으로 설정합니다. 업데이트 영역은 InvalidateRect 또는 InvalidateRgn 함수 및 크기 조정, 이동, 만들기, 스크롤 또는 클라이언트 영역에 영향을 주는 기타 작업 후에 시스템에 의해 설정됩니다. 업데이트 영역이 지우기로 표시되면 BeginPaint 는 창에 WM_ERASEBKGND 메시지를 보냅니다.

애플리케이션은 WM_PAINT 메시지에 대한 응답을 제외하고 BeginPaint를 호출해서는 안 됩니다. BeginPaint에 대한 각 호출에는 EndPaint 함수에 대한 해당 호출이 있어야 합니다.

캐리트가 그려질 영역에 있는 경우 BeginPaint 는 자동으로 캐리트를 숨겨 지울 수 없도록 합니다.

창의 클래스에 배경 브러시가 있는 경우 BeginPaint 는 반환하기 전에 해당 브러시를 사용하여 업데이트 영역의 배경을 지웁합니다.

DPI 가상화

이 API는 DPI 가상화에 참여하지 않습니다. 반환된 출력은 항상 물리적 픽셀의 관점에서 입니다.

예제

예제는 클라이언트 영역에서 그리기를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-draw-l1-1-0(Windows 8 도입)