IPrintOemUI::D ocumentPropertySheets 메서드(prcomoem.h)

아티클
08/07/2023

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 함수와 동일한 유형의 작업을 수행합니다. 두 함수 모두 동일한 입력 매개 변수를 갖습니다.

사용자 인터페이스 플러그 인 IPrintOemUI::DocumentPropertySheets 을 제공하는 경우 드라이버의 DrvDocumentPropertySheets 함수가 호출된 후 메서드가 호출됩니다.

가 호출되면 IPrintOemUI::DocumentPropertySheetsPROPSHEETUI_INFO 구조체의 lParamInit 멤버에 OEMUIPSPARAM 구조체의 주소가 포함됩니다.

이 메서드를 구현하는 경우 일반적으로 사용자 수정을 처리하기 위해 _CPSUICALLBACK 형식의 콜백 함수도 제공합니다. 이 콜백 함수는 IPrintOemDriverUI::D rvUpdateUISetting 을 호출하여 사용자 인터페이스 설정과 관련된 값이 수정된 경우, 값이 드라이버의 DEVMODEW 구조체(플러그 인의 프라이빗 DEVMODEW 멤버 대신) 또는 레지스트리 키에 저장된 경우 드라이버에 알려야 합니다.

여러 사용자 인터페이스 플러그 인에서 메서드를 내보낼 경우 IPrintOemUI::DocumentPropertySheets 플러그 인이 설치를 위해 지정된 순서대로 메서드가 호출됩니다.

한 사용자 인터페이스 플러그 인이 여러 프린터 모델을 지원하고 이러한 모델 중 일부에 대해서만 새 페이지를 표시하려는 경우 메서드는 페이지를 필요로 하지 않는 모델에 IPrintOemUI::DocumentPropertySheets 대해 실제로 페이지를 추가하지 않고도 성공 반환 값을 제공해야 합니다.

사용자 인터페이스 플러그 인을 만들고 설치하는 방법에 대한 자세한 내용은 Microsoft의 프린터 드라이버 사용자 지정을 참조하세요.