CPSUI 제공 함수

Important

최신 인쇄 플랫폼은 Windows에서 프린터와 통신하는 데 선호되는 수단입니다. 프린터 장치 개발을 위해 Windows 10 및 11의 인쇄 환경을 사용자 지정하려면 MICROSOFT의 IPP 받은 편지함 클래스 드라이버와 PSA(인쇄 지원 앱)를 사용하는 것이 좋습니다.

자세한 내용은 최신 인쇄 플랫폼 및 인쇄 지원 앱 디자인 가이드를 참조하세요.

CPSUI는 애플리케이션에 다음과 같은 두 가지 중요한 함수를 제공합니다.

  • CommonPropertySheetUI

    CommonPropertySheetUI 함수는 CPSUI의 진입점입니다. 이 함수는 속성 시트 페이지를 만들고 표시한 다음 사용자가 보고 수정할 수 있도록 합니다.

    애플리케이션에서 CommonPropertySheetUI호출하면 만들 페이지를 설명하는 페이지 만들기 콜백의 주소를 제공합니다. CPSUI는 이 콜백을 호출하여 페이지 설명을 가져옵니다. 그런 다음 페이지를 표시하고, 애플리케이션 사용자가 페이지에 포함된 값을 수정할 수 있도록 하고, 페이지 이벤트 콜백을 사용하여 수정된 값을 애플리케이션에 전달합니다. CommonPropertySheetUI 함수는 사용자가 확인 또는 취소를 클릭하여 속성 시트를 해제할 때까지 반환되지 않습니다.

    프린터 인터페이스 DLL은 이 함수를 호출하지 않습니다. 인쇄 스풀러에 의해 호출됩니다.

  • ComPropSheet

    ComPropSheet 함수는 애플리케이션에서 CPSUI에 속성 시트 페이지를 설명하여 CPSUI를 만들고 표시할 수 있도록 하는 수단입니다. CPSUI 애플리케이션은 페이지 만들기 콜백 내에서 이 함수를 호출합니다. 일반적으로 페이지 설명에는 애플리케이션 사용자가 페이지 값을 수정할 때 CPSUI가 호출하는 페이지 이벤트 콜백에 대한 포인터가 포함됩니다.

이러한 함수가 호출되는 시기에 대한 자세한 설명은 프린터 드라이버에서 CPSUI 사용을 참조 하세요.

애플리케이션 제공 대화 상자 프로시저에서 두 개의 추가 CPSUI 제공 함수인 SetCPSUIUserDataGetCPSUIUserData를 사용하여 애플리케이션 제공 값을 저장하고 검색할 수 있습니다.