Méthode IPrintOemUI ::D ocumentPropertySheets (prcomoem.h)

Article
02/29/2024

La IPrintOemUI::DocumentPropertySheets méthode permet à un plug-in d’interface utilisateur d’ajouter une nouvelle page à la feuille de propriétés d’un périphérique d’imprimante.

Syntaxe

HRESULT DocumentPropertySheets(
  PPROPSHEETUI_INFO pPSUIInfo,
  LPARAM            lParam
);

Paramètres

pPSUIInfo

Pointeur fourni par l’appelant vers une structure PROPSHEETUI_INFO .

lParam

Valeur fournie par l’appelant qui dépend de la valeur de raison dans pPSUIInfo ->Raison. La valeur de raison peut être l’une des constantes suivantes, qui sont définies dans compstui.h. Pour plus d’informations sur ces constantes, consultez la section Remarques et la description du paramètre lParam dans le type de fonction PFNPROPSHEETUI .

PROPSHEETUI_REASON_DESTROY

PROPSHEETUI_REASON_GET_ICON

PROPSHEETUI_REASON_GET_INFO_HEADER

PROPSHEETUI_REASON_INIT

PROPSHEETUI_REASON_SET_RESULT

Valeur retournée

La valeur de retour dépend du contenu du membre Reason de la structure PROPSHEETUI_INFO. Pour plus d’informations, consultez la description de DrvDocumentPropertySheets.

Remarques

La méthode d’un IPrintOemUI::DocumentPropertySheets plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvDocumentPropertySheets qui est exportée par des DLL d’interface d’imprimante en mode utilisateur. Les deux fonctions ont les mêmes paramètres d’entrée.

Si vous fournissez un plug-in d’interface utilisateur, la IPrintOemUI::DocumentPropertySheets méthode est appelée après l’appel de la fonction DrvDocumentPropertySheets du pilote.

Quand IPrintOemUI::DocumentPropertySheets est appelé, le membre lParamInit de la structure PROPSHEETUI_INFO contient l’adresse d’une structure OEMUIPSPARAM .

Si vous implémentez cette méthode, vous fournissez généralement une fonction de rappel de type _CPSUICALLBACK pour gérer les modifications utilisateur. Cette fonction de rappel doit appeler IPrintOemDriverUI ::D rvUpdateUISetting pour informer le pilote lorsque la valeur associée à un paramètre d’interface utilisateur a été modifiée, si la valeur est stockée dans la structure DEVMODEW du pilote (au lieu des membres DEVMODEW privés du plug-in ) ou dans les clés de Registre.

Si IPrintOemUI::DocumentPropertySheets les méthodes sont exportées par plusieurs plug-ins d’interface utilisateur, les méthodes sont appelées dans l’ordre dans lequel les plug-ins sont spécifiés pour l’installation.

Si un plug-in d’interface utilisateur prend en charge plusieurs modèles d’imprimante et que vous souhaitez uniquement afficher la nouvelle page pour certains de ces modèles, la IPrintOemUI::DocumentPropertySheets méthode doit simplement fournir une valeur de retour de réussite, sans ajouter réellement la page, pour les modèles qui n’ont pas besoin de la page.

Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimante Microsoft.