Freigeben über


IPrintOemUI2::HideStandardUI-Methode (prcomoem.h)

Mit IPrintOemUI2::HideStandardUI der -Methode kann ein Benutzeroberfläche-Plug-In angeben, ob die Standardeigenschaftenblätter angezeigt oder ausgeblendet werden sollen. Ab Microsoft Windows XP kann diese Methode durch ein Pscript5-Benutzeroberfläche-Plug-In implementiert werden. Ab Windows Vista kann diese Methode durch ein Unidrv-Benutzeroberfläche-Plug-In implementiert werden.

Syntax

HRESULT HideStandardUI(
  DWORD dwMode
);

Parameter

dwMode

Gibt an, welcher Typ der Eigenschaftenblattbenutzeroberfläche – Dokumenteigenschaftenblatt oder Geräteeigenschaftenblatt – ausgeblendet werden soll. Dieser Parameter sollte auf eine der folgenden Konstanten festgelegt werden, die in printoem.h definiert sind:

Wert Bedeutung
OEMCUIP_DOCPROP Blenden Sie die Benutzeroberfläche des Standarddokumenteigenschaftenblatts aus.
OEMCUIP_PRNPROP Blenden Sie die Benutzeroberfläche des Standardeigenschaftenblatts aus.

Rückgabewert

Bei Erfolg sollte diese Methode S_OK zurückgeben. Andernfalls sollte E_NOTIMPL zurückgegeben werden. Weitere Informationen finden Sie unter Hinweise.

Hinweise

Diese Methode wird in Windows Vista für Pscript 5- und Unidrv-Plug-Ins und in Windows XP nur für Pscript5-Plug-Ins unterstützt.

Wenn pPSUIInfo->-Reason auf PROPSHEETUI_REASON_INIT festgelegt ist, ruft der Treiber innerhalb der DDIs DrvDocumentPropertySheets oder DrvDevicePropertySheets die IPrintOemUI2::HideStandardUI -Methode auf, um das UI-Plug-In zu Anforderungen an die Benutzeroberfläche zu fragen. Diese Methode kann auf vier Arten reagieren:

  1. Blenden Sie die Benutzeroberfläche des Standarddokumenteigenschaftenblatts aus.
  2. Blenden Sie die Benutzeroberfläche des Standardeigenschaftenblatts aus.
  3. Blenden Sie die gesamte Standardeigenschaftenblatt-Benutzeroberfläche aus.
  4. Blenden Sie keine Standardeigenschaftenblattbenutzeroberfläche aus.
In der folgenden Tabelle wird zusammengefasst, wie die IPrintOemUI2::HideStandardUI Methode in diesen Situationen reagieren würde.
Um diese Antwort anzugeben... IPrintOemUI2::HideStandardUI gibt zurück...
Blenden Sie die Benutzeroberfläche des Standarddokumenteigenschaftenblatts aus. Das Plug-In implementiert eine eigene Benutzeroberfläche des Dokumenteigenschaftenblatts. Wenn dwMode == OEMCUIP_DOCPROP, geben Sie S_OK zurück. andernfalls E_NOTIMPL zurückgeben.
Blenden Sie die Benutzeroberfläche des Standardeigenschaftenblatts aus. Das Plug-In implementiert eine eigene Benutzeroberfläche des Geräteeigenschaftenblatts. Wenn dwMode == OEMCUIP_PRNPROP, geben Sie S_OK zurück. andernfalls E_NOTIMPL zurückgeben.
Blenden Sie die gesamte Standardeigenschaftenblatt-Benutzeroberfläche aus. Das Plug-In implementiert ein eigenes Dokumenteigenschaftenblatt und eine eigene Benutzeroberfläche des Geräteeigenschaftenblatts. Gibt S_OK zurück, unabhängig vom Wert von dwMode.
Zeigt die gesamte Standardeigenschaftenblatt-Benutzeroberfläche an. Gibt E_NOTIMPL zurück, unabhängig vom Wert von dwMode.
 

Wenn die IPrintOemUI2::HideStandardUI -Methode dem Treiber angibt, dass alle Standardeigenschaftenblätter ausgeblendet werden sollen, lässt der Treiber Aufrufe an compstui.dll aus (siehe Pscript-Komponenten), um die Standardeigenschaftenblätter hinzuzufügen. Ein UI-Plug-In muss mindestens eine benutzerdefinierte Eigenschaftenblatt-Benutzeroberfläche implementieren, wenn IPrintOemUI2::HideStandardUI S_OK zurückgegeben wird.

Wenn auf dem Drucker mehrere UI-Plug-Ins installiert sind, ruft der Treiber UI-Plug-Ins in der Reihenfolge auf, in der sie installiert wurden, bis eines von ihnen S_OK zurückgibt, oder bis alle UI-Plug-Ins aufgerufen wurden und keines von ihnen S_OK zurückgegeben wurde. Der frühere Fall gibt dem Treiber an, dass die Standardeigenschaftenblatt-Benutzeroberfläche ausgeblendet werden soll. Der letztere Fall gibt dem Treiber an, dass die Standardeigenschaftenblatt-Benutzeroberfläche angezeigt werden soll.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile prcomoem.h (einschließlich Prcomoem.h)

Weitere Informationen

DrvDevicePropertySheets

DrvDocumentPropertySheets

IPrintOemUI2