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

  • 아티클

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-->Reason가 PROPSHEETUI_REASON_INIT 설정된 경우 DrvDocumentPropertySheets 또는 DrvDevicePropertySheets DDI 내에서 드라이버는 메서드를 호출 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 구성 요소 참조). UI 플러그 인은 S_OK 반환하는 경우 IPrintOemUI2::HideStandardUI 하나 이상의 사용자 지정 속성 시트 UI를 구현해야 합니다.

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

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 prcomoem.h(Prcomoem.h 포함)

추가 정보

DrvDevicePropertySheets

DrvDocumentPropertySheets

IPrintOemUI2