IPrintOemUI::D ocumentPropertySheets 메서드(prcomoem.h)
IPrintOemUI::DocumentPropertySheets 메서드를 사용하면 사용자 인터페이스 플러그 인이 프린터 장치의 문서 속성 시트에 새 페이지를 추가할 수 있습니다.
통사론
HRESULT DocumentPropertySheets(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
매개 변수
pPSUIInfo
PROPSHEETUI_INFO 구조체에 대한 호출자 제공 포인터입니다.
lParam
pPSUIInfo 이유 값(>Reason)에 따라 달라지는 호출자 제공 값입니다. 이유 값은 compstui.h에 정의된 다음 상수 중 하나일 수 있습니다. 이러한 상수에 대한 자세한 내용은 PFNPROPSHEETUI 함수 형식의 설명 섹션 및 lParam 매개 변수 설명을 참조하세요.
PROPSHEETUI_REASON_DESTROY
PROPSHEETUI_REASON_GET_ICON
PROPSHEETUI_REASON_GET_INFO_HEADER
PROPSHEETUI_REASON_INIT
PROPSHEETUI_REASON_SET_RESULT
반환 값
반환 값은 PROPSHEETUI_INFO 구조체의 Reason 멤버의 내용에 따라 달라집니다. 자세한 내용은 DrvDocumentPropertySheets대한 설명을 참조하세요.
발언
사용자 인터페이스 플러그 인의 IPrintOemUI::DocumentPropertySheets 메서드는 사용자 모드 프린터 인터페이스 DLL에서 내보낸 DrvDocumentPropertySheets 함수와 동일한 유형의 작업을 수행합니다. 두 함수 모두 입력 매개 변수가 동일합니다.
사용자 인터페이스 플러그 인을 제공하는 경우 드라이버의 DrvDocumentPropertySheets 함수가 호출된 후 IPrintOemUI::DocumentPropertySheets 메서드가 호출됩니다.
IPrintOemUI::DocumentPropertySheets 호출되면 PROPSHEETUI_INFO 구조체의 lParamInit 멤버에는 OEMUIPSPARAM 구조체의 주소가 포함됩니다.
이 메서드를 구현하는 경우 일반적으로 _CPSUICALLBACK형식의 콜백 함수를 제공하여 사용자 수정을 처리합니다. 이 콜백 함수는 IPrintOemDriverUI::D rvUpdateUISetting 호출하여 사용자 인터페이스 설정과 연결된 값이 수정된 경우, 값이 플러그 인의 프라이빗 DEVMODEW 멤버 대신 드라이버의 DEVMODEW 구조체 또는 레지스트리 키에 저장되는 경우 드라이버에 알려야 합니다.
여러 사용자 인터페이스 플러그 인에서 IPrintOemUI::DocumentPropertySheets 메서드를 내보낼 경우 플러그 인을 설치하도록 지정한 순서대로 메서드가 호출됩니다.
한 사용자 인터페이스 플러그 인이 여러 프린터 모델을 지원하고 이러한 모델 중 일부에 대해서만 새 페이지를 표시하려는 경우 IPrintOemUI::DocumentPropertySheets 메서드는 페이지가 필요하지 않은 모델에 대해 실제로 페이지를 추가하지 않고 성공 반환 값을 제공해야 합니다.
사용자 인터페이스 플러그 인을 만들고 설치하는 방법에 대한 자세한 내용은 Microsoft 프린터 드라이버사용자 지정을 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | prcomoem.h(Prcomoem.h, Compstui.h 포함) |