피드백

IPrintOemUI2::HideStandardUI 메서드(prcomoem.h)

  • 아티클
  • 읽는 데 4분 걸림

이 IPrintOemUI2::HideStandardUI 메서드를 사용하면 사용자 인터페이스 플러그 인에서 표준 속성 시트를 표시할지 숨길지 여부를 지정할 수 있습니다. Microsoft Windows XP부터 Pscript5 사용자 인터페이스 플러그 인에서 이 메서드를 구현할 수 있습니다. Windows Vista부터 이 메서드는 Unidrv 사용자 인터페이스 플러그 인에서 구현할 수 있습니다.

구문

HRESULT HideStandardUI(
  DWORD dwMode
);

매개 변수

dwMode

숨길 속성 시트 UI 유형(문서 속성 시트 또는 디바이스 속성 시트)을 지정합니다. 이 매개 변수는 printoem.h에 정의된 다음 상수 중 하나로 설정해야 합니다.

값 의미
OEMCUIP_DOCPROP 표준 문서 속성 시트 UI를 숨깁니다.
OEMCUIP_PRNPROP 표준 디바이스 속성 시트 UI를 숨깁니다.

반환 값

성공하면 이 메서드는 S_OK 반환해야 합니다. 그렇지 않으면 E_NOTIMPL 반환해야 합니다. 추가 정보는 비고를 참조하세요.

설명

이 메서드는 Pscript 5 및 Unidrv 플러그 인용 Windows Vista 및 Pscript5 플러그 인에 대해서만 Windows XP에서 지원됩니다.

pPSUIInfo-->이유가 PROPSHEETUI_REASON_INIT 설정된 경우 DrvDocumentPropertySheets 또는 DrvDevicePropertySheets DDIs 내에서 드라이버는 메서드를 호출 IPrintOemUI2::HideStandardUI 하여 사용자 인터페이스 요청에 대해 UI 플러그 인을 요청합니다. 이 메서드는 다음 네 가지 방법으로 응답할 수 있습니다.

  1. 표준 문서 속성 시트 UI를 숨깁니다.
  2. 표준 디바이스 속성 시트 UI를 숨깁니다.
  3. 모든 표준 속성 시트 UI를 숨깁니다.
  4. 표준 속성 시트 UI를 숨기지 마세요.
다음 표에서는 이러한 각 상황에서 메서드가 IPrintOemUI2::HideStandardUI 응답하는 방법을 요약합니다.
이 응답을 나타내려면... IPrintOemUI2::HideStandardUI 반환...
표준 문서 속성 시트 UI를 숨깁니다. 플러그 인은 자체 문서 속성 시트 UI를 구현합니다. dwMode == OEMCUIP_DOCPROP 경우 S_OK; 그렇지 않으면 E_NOTIMPL 반환합니다.
표준 디바이스 속성 시트 UI를 숨깁니다. 플러그 인은 자체 디바이스 속성 시트 UI를 구현합니다. dwMode == OEMCUIP_PRNPROP 경우 S_OK; 그렇지 않으면 E_NOTIMPL 반환합니다.
모든 표준 속성 시트 UI를 숨깁니다. 플러그 인은 자체 문서 속성 시트 및 디바이스 속성 시트 UI를 구현합니다. dwMode 값에 관계없이 S_OK 반환합니다.
모든 표준 속성 시트 UI를 표시합니다. dwMode 값에 관계없이 E_NOTIMPL 반환합니다.

메서드가 IPrintOemUI2::HideStandardUI 드라이버에 모든 표준 속성 시트를 숨겨야 함을 나타내는 경우 드라이버는 표준 속성 시트를 추가하기 위해 compstui.dll 호출( Pscript 구성 요소 참조)을 생략합니다. S_OK 반환하는 경우 IPrintOemUI2::HideStandardUI UI 플러그 인은 하나 이상의 사용자 지정 속성 시트 UI를 구현해야 합니다.

프린터에 여러 UI 플러그 인이 설치되어 있는 경우 드라이버는 설치한 순서대로 UI 플러그 인을 호출합니다. 그 중 하나가 S_OK 반환하거나 모든 UI 플러그 인이 호출되고 S_OK 반환되지 않을 때까지 드라이버가 UI 플러그 인을 호출합니다. 이전 사례는 표준 속성 시트 UI를 숨겨야 한다는 것을 드라이버에 나타냅니다. 후자의 경우는 표준 속성 시트 UI를 표시해야 한다는 것을 드라이버에 나타냅니다.

요구 사항

   
대상 플랫폼 데스크톱
헤더 prcomoem.h(Prcomoem.h 포함)

참고 항목

DrvDevicePropertySheets

DrvDocumentPropertySheets

IPrintOemUI2