IPrintOemUI ::D evicePropertySheets, méthode (prcomoem.h)
La méthode IPrintOemUI::DevicePropertySheets permet à un plug-in d’interface utilisateur d’ajouter une nouvelle page à la feuille de propriétés de l’imprimante d’un appareil d’imprimante.
Syntaxe
HRESULT DevicePropertySheets(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Paramètres
pPSUIInfo
Pointeur fourni par l’appelant vers une structure de 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 Notes 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 de retour
La valeur de retour dépend du contenu du membre Reason de la structure de PROPSHEETUI_INFO. Pour plus d’informations, consultez la description de DrvDevicePropertySheets.
Remarques
La méthode IPrintOemUI::DevicePropertySheets d’un plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvDevicePropertySheets 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 méthode IPrintOemUI::DevicePropertySheets est appelée après l’appel de la fonction DrvDevicePropertySheets du pilote.
Quand IPrintOemUI::DevicePropertySheets est appelée, 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 _CPSUICALLBACK-typée 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::DevicePropertySheets 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 si vous souhaitez que la nouvelle page soit affichée pour certains de ces modèles, la méthode IPrintOemUI::DevicePropertySheets doit simplement fournir une valeur de retour réussie, sans réellement ajouter la page, pour les modèles qui ne nécessitent pas la page.
Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimantes microsoft.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | prcomoem.h (include Prcomoem.h) |