IPrintOemUI2 ::HideStandardUI, méthode (prcomoem.h)
La méthode IPrintOemUI2::HideStandardUI 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 de retour
En cas de réussite, cette méthode doit retourner S_OK. Sinon, elle doit retourner E_NOTIMPL. Pour plus d’informations, consultez les remarques.
Remarques
Cette méthode est prise en charge dans les plug-ins Windows Vista pour Pscript 5 et Unidrv, et dans Windows XP uniquement pour les plug-ins Pscript5.
Dans les DrvDocumentPropertySheets ou DrvDevicePropertySheets DDIs lorsque pPSUIInfo-->Reason est défini sur PROPSHEETUI_REASON_INIT, le pilote appelle la méthode IPrintOemUI2::HideStandardUI pour demander au plug-in d’interface utilisateur sur les demandes d’interface utilisateur. Cette méthode peut répondre de quatre façons :
- 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 l’interface utilisateur de la feuille de propriétés standard.
- Ne masquez aucune interface utilisateur de feuille de propriétés standard.
IPrintOemUI2::HideStandardUI répondrait dans chacune de ces situations.
| Pour indiquer cette réponse... | IPrintOemUI2 ::HideStandardUI renvoie... |
|---|---|
| Masquer l’interface utilisateur de la feuille de propriétés de document standard. Le plug-in implémente son 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 son propre interface utilisateur de la feuille de propriétés d’appareil. | Si dwMode == OEMCUIP_PRNPROP, retournez S_OK ; sinon, retournez E_NOTIMPL. |
| Masquer 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 l’interface utilisateur de la feuille de propriétés de l’appareil. | Retournez S_OK, quelle que soit la valeur de dwMode. |
| Affichez l’interface utilisateur de la feuille de propriétés standard. | Retourne E_NOTIMPL, quelle que soit la valeur de dwMode. |
Si la méthode IPrintOemUI2::HideStandardUI 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 l’imprimante a plusieurs plug-ins d’interface utilisateur installés, le pilote appelle les plug-ins d’interface utilisateur dans l’ordre dans lequel ils ont été installés, jusqu’à ce qu’un d’entre eux retourne S_OK, ou jusqu’à ce que tous les plug-ins de l’interface utilisateur aient été appelés et qu’aucun d’entre eux n’ait retourné S_OK. L’ancien 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.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |