BeginPaint 함수(winuser.h)
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 도입) |