IPrintOemUI2 ::HideStandardUI, méthode (prcomoem.h)
La IPrintOemUI2::HideStandardUI méthode permet à un plug-in d’interface utilisateur de spécifier si les feuilles de propriétés standard doivent être affichées ou masquées. À compter de Microsoft Windows XP, cette méthode peut être implémentée par un plug-in d’interface utilisateur Pscript5. À compter de Windows Vista, cette méthode peut être implémentée par un plug-in d’interface utilisateur Unidrv.
Syntaxe
HRESULT HideStandardUI(
DWORD dwMode
);
Paramètres
dwMode
Spécifie le type d’interface utilisateur de la feuille de propriétés (feuille de propriétés de document ou feuille de propriétés d’appareil) à masquer. Ce paramètre doit être défini sur l’une des constantes suivantes, qui sont définies dans printoem.h :
| Valeur | Signification |
|---|---|
| OEMCUIP_DOCPROP | Masquer l’interface utilisateur de la feuille de propriétés de document standard. |
| OEMCUIP_PRNPROP | Masquer l’interface utilisateur de la feuille de propriétés d’appareil standard. |
Valeur retournée
En cas de réussite, cette méthode doit retourner S_OK. Sinon, elle doit retourner E_NOTIMPL. Pour plus d’informations, consultez Remarques.
Remarques
Cette méthode est prise en charge dans Windows Vista pour les plug-ins Pscript 5 et Unidrv, et dans Windows XP uniquement pour les plug-ins Pscript5.
Dans les DDIs DrvDocumentPropertySheets ou DrvDevicePropertySheets lorsque pPSUIInfo-->Reason est défini sur PROPSHEETUI_REASON_INIT, le pilote appelle la IPrintOemUI2::HideStandardUI méthode pour demander au plug-in d’interface utilisateur les demandes d’interface utilisateur. Cette méthode peut répondre de l’une des quatre façons suivantes :
- Masquer l’interface utilisateur de la feuille de propriétés de document standard.
- Masquer l’interface utilisateur de la feuille de propriétés d’appareil standard.
- Masquer toute l’interface utilisateur de la feuille de propriétés standard.
- Ne masquez pas l’interface utilisateur de la feuille de propriétés standard.
IPrintOemUI2::HideStandardUI méthode répond dans chacune de ces situations.
| Pour indiquer cette réponse... | IPrintOemUI2 ::HideStandardUI retourne... |
|---|---|
| Masquer l’interface utilisateur de la feuille de propriétés de document standard. Le plug-in implémente sa propre interface utilisateur de feuille de propriétés de document. | Si dwMode == OEMCUIP_DOCPROP, retournez S_OK ; sinon, retournez E_NOTIMPL. |
| Masquer l’interface utilisateur de la feuille de propriétés d’appareil standard. Le plug-in implémente sa propre interface utilisateur de la feuille de propriétés d’appareil. | Si dwMode == OEMCUIP_PRNPROP, retournez S_OK ; sinon, retournez E_NOTIMPL. |
| Masquer toute l’interface utilisateur de la feuille de propriétés standard. Le plug-in implémente sa propre feuille de propriétés de document et son interface utilisateur de feuille de propriétés d’appareil. | Retourne S_OK, quelle que soit la valeur de dwMode. |
| Afficher l’ensemble de l’interface utilisateur de la feuille de propriétés standard. | Retourne E_NOTIMPL, quelle que soit la valeur de dwMode. |
Si la IPrintOemUI2::HideStandardUI méthode indique au pilote que toutes les feuilles de propriétés standard doivent être masquées, le pilote omet les appels à compstui.dll (voir Composants Pscript) pour ajouter les feuilles de propriétés standard. Un plug-in d’interface utilisateur doit implémenter au moins une interface utilisateur de feuille de propriétés personnalisée si IPrintOemUI2::HideStandardUI retourne S_OK.
Lorsque plusieurs plug-ins d’interface utilisateur sont installés sur l’imprimante, le pilote appelle les plug-ins d’interface utilisateur dans l’ordre dans lequel ils ont été installés, jusqu’à ce que l’un d’entre eux retourne S_OK, ou jusqu’à ce que tous les plug-ins d’interface utilisateur aient été appelés et qu’aucun d’entre eux n’ait retourné S_OK. Le premier cas indique au pilote que l’interface utilisateur de la feuille de propriétés standard doit être masquée. Ce dernier cas indique au pilote que l’interface utilisateur de la feuille de propriétés standard doit être affichée.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | prcomoem.h (include Prcomoem.h) |