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:
- Blenden Sie die Benutzeroberfläche des Standarddokumenteigenschaftenblatts aus.
- Blenden Sie die Benutzeroberfläche des Standardeigenschaftenblatts aus.
- Blenden Sie die gesamte Standardeigenschaftenblatt-Benutzeroberfläche aus.
- Blenden Sie keine Standardeigenschaftenblattbenutzeroberfläche aus.
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) |