Share via

PrintWindow 함수(winuser.h)

  • 아티클

PrintWindow 함수는 시각적 창을 지정된 DC(디바이스 컨텍스트), 일반적으로 프린터 DC에 복사합니다.

구문

BOOL PrintWindow(
  HWND hwnd,
  HDC  hdcBlt,
  UINT nFlags
);

매개 변수

hwnd

복사할 창에 대한 핸들입니다.

hdcBlt

디바이스 컨텍스트에 대한 핸들입니다.

nFlags

그리기 옵션입니다. 다음 값 중 하나일 수 있습니다.

값 의미
PW_CLIENTONLY
 창의 클라이언트 영역만 hdcBlt에 복사됩니다. 기본적으로 전체 창이 복사됩니다.

반환 값

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

함수가 실패하면 0을 반환합니다.

설명

참고 이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현과 같은 런타임 요인(애플리케이션을 작성할 때 예측하기 어려운 요소)에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.
 
hWnd에서 참조하는 창을 소유하는 애플리케이션은 PrintWindow 호출을 처리하고 hdcBlt에서 참조하는 디바이스 컨텍스트에서 이미지를 렌더링합니다. 애플리케이션은 WM_PRINT 메시지를 받거나 PW_PRINTCLIENT 플래그가 지정된 경우 WM_PRINTCLIENT 메시지를 받습니다. 자세한 내용은 WM_PRINT 및 WM_PRINTCLIENT 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-draw-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)

추가 정보

메시지 그리기 및 그리기

그리기 및 그리기 개요

WM_PRINT

WM_PRINTCLIENT