IPrintOemUI2 ::HideStandardUI, méthode (prcomoem.h)

Article
08/07/2023

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.

Le tableau suivant récapitule la façon dont la 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.