LPPAGEPAINTHOOK 콜백 함수(commdlg.h)

  • 아티클

페이지 설정 대화 상자에서 샘플 페이지의 그리기를 사용자 지정할 수 있는 메시지를 받습니다. PagePaintHook 후크 프로시저는 PageSetupDlg 함수와 함께 사용되는 애플리케이션 정의 또는 라이브러리 정의 콜백 함수입니다.

LPPAGEPAINTHOOK 형식은 이 콜백 함수에 대한 포인터를 정의합니다. PagePaintHook 은 애플리케이션 정의 또는 라이브러리 정의 함수 이름의 자리 표시자입니다.

구문

LPPAGEPAINTHOOK Lppagepainthook;

UINT_PTR Lppagepainthook(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

매개 변수

unnamedParam1

페이지 설정 대화 상자에 대한 핸들입니다.

unnamedParam2

수신되는 메시지의 식별자입니다.

unnamedParam3

메시지에 대한 추가 정보입니다. 정확한 의미는 명명되지 않은Param2 매개 변수의 값에 따라 달라집니다.

unnamedParam4

메시지에 대한 추가 정보입니다. 정확한 의미는 명명되지 않은Param2 매개 변수의 값에 따라 달라집니다.

반환 값

그리기 시퀀스(WM_PSD_PAGESETUPDLG,WM_PSD_FULLPAGERECT 또는 WM_PSD_MINMARGINRECT)의 처음 3개 메시지에 대해 후크 프로시저가 TRUE를 반환하는 경우 대화 상자는 더 이상 메시지를 보내지 않고 다음 번에 시스템이 샘플 페이지를 다시 그릴 때까지 샘플 페이지에 그리지 않습니다. 후크 프로시저가 세 메시지 모두에 대해 FALSE 를 반환하는 경우 대화 상자는 그리기 시퀀스의 나머지 메시지를 보냅니다.

후크 프로시저가 그리기 시퀀스의 나머지 메시지에 대해 TRUE 를 반환하는 경우 대화 상자는 샘플 페이지의 해당 부분을 그리지 않습니다. 후크 프로시저가 이러한 메시지에 대해 FALSE 를 반환하는 경우 대화 상자는 샘플 페이지의 해당 부분을 그립니다.

설명

페이지 설정 대화 상자에는 사용자의 선택 항목이 인쇄된 출력의 모양에 미치는 영향을 보여 주는 샘플 페이지의 이미지가 포함되어 있습니다. 이미지는 선택한 용지 또는 봉투 유형을 나타내는 사각형으로 구성되며, 현재 여백을 나타내는 점선 사각형과 인쇄된 페이지에서 텍스트가 표시되는 방식을 보여 주는 부분(그리스어 텍스트) 문자로 구성됩니다. PageSetupDlg 함수를 사용하여 페이지 설정 대화 상자를 만드는 경우 PagePaintHook 후크 프로시저를 제공하여 샘플 페이지의 모양을 사용자 지정할 수 있습니다.

후크 프로시저를 사용하도록 설정하려면 생성 함수에 전달한 PAGESETUPDLG 구조를 사용합니다. lpfnPagePaintHook 멤버의 후크 프로시저에 대한 포인터를 지정하고 Flags 멤버에서 PSD_ENABLEPAGEPAINTHOOK 플래그를 지정합니다.

대화 상자가 샘플 페이지의 내용을 그리려고 할 때마다 후크 프로시저는 나열된 순서대로 다음 메시지를 받습니다.

메시지 의미
WM_PSD_PAGESETUPDLG 대화 상자가 샘플 페이지를 그리려고 합니다. 후크 프로시저는 이 메시지를 사용하여 샘플 페이지의 내용을 그릴 준비를 할 수 있습니다.
WM_PSD_FULLPAGERECT 대화 상자가 샘플 페이지를 그리려고 합니다. 이 메시지는 샘플 페이지의 경계 사각형을 지정합니다.
WM_PSD_MINMARGINRECT 대화 상자가 샘플 페이지를 그리려고 합니다. 이 메시지는 여백 사각형을 지정합니다.
WM_PSD_MARGINRECT 대화 상자가 여백 사각형을 그리려고 합니다.
WM_PSD_GREEKTEXTRECT 대화 상자가 여백 사각형 안에 그리스어 텍스트를 그리려고 합니다.
WM_PSD_ENVSTAMPRECT 대화 상자가 봉투 샘플 페이지의 봉투 스탬프 사각형에 그리려고 합니다. 이 메시지는 봉투에 대해서만 전송됩니다.
WM_PSD_YAFULLPAGERECT 대화 상자가 봉투 샘플 페이지의 반환 주소 부분을 그리려고 합니다. 이 메시지는 봉투 및 기타 용지 크기로 전송됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 commdlg.h(Windows.h 포함)

추가 정보

일반 대화 상자 라이브러리

개념

PAGESETUPDLG

PageSetupDlg

참조