DrvDocumentPropertySheets, fonction (winddiui.h)
La dll d’interface d’imprimante DrvDocumentPropertySheets est responsable de la création de pages de feuille de propriétés qui décrivent les propriétés d’un document d’impression.
Syntaxe
LONG DrvDocumentPropertySheets(
[in, optional] PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam
);
Paramètres
[in, optional] pPSUIInfo
Pointeur fourni par l’appelant vers une structure PROPSHEETUI_INFO. Peut être NULL (consultez la section Remarques suivantes).
lParam
Valeur entière fournie par l’appelant qui dépend du contenu du Reason membre de la structure PROPSHEETUI_INFO, comme indiqué dans le tableau suivant.
| Valeur de raison | Définition de lParam |
|---|---|
| PROPSHEETUI_REASON_INIT | Pointeur vers une structureDOCUMENTPROPERTYHEADER. |
| Toutes les autres valeurs de raison | Consultez la description du paramètre lParam pour le type de fonction PFNPROPSHEETUI. (L’adresse de la structureDOCUMENTPROPERTYHEADERest contenue dans le membre lParamInit de la structure PROPSHEETUI_INFO.) |
Valeur de retour
Si pPSUIInfo est NULL et si lParam ->fMode est égal à zéro ou lParam ->pdmOut est NULL, cette fonction doit retourner la taille, en octets, de la structure DEVMODEW de l’imprimante. Sinon, la valeur de retour de la fonction est la même que celle décrite dans la section ReturnValue de la PFNPROPSHEETUI type de fonction. Pour plus d’informations, consultez la section Remarques.
Remarques
Toutes les DLL d’interface d’imprimante doivent fournir une fonction DrvDocumentPropertySheets, définie à l’aide du type de fonction PFNPROPSHEETUI. L’objectif de la fonction est d’appeler la fonction ComPropSheet, fournie par CPSUI, pour spécifier des pages de feuille de propriétés contenant des propriétés modifiables par l’utilisateur pour les documents imprimés.
Si la valeur reçue pour le paramètre pPSUIInfo n’est pas NULL, le spouleur d’impression du système d’exploitation basé sur NT appelle indirectement la fonction via CPSUI. Les règles suivantes s’appliquent :
La fonction doit effectuer des opérations comme décrit pour le type de fonction PFNPROPSHEETUI.
Les indicateurs dans le fMode membre de la structure DOCUMENTPROPERTYHEADER indiquent les pages de feuille de propriétés à afficher et si l’utilisateur doit être autorisé à modifier les propriétés d’un document. Les seuls indicateurs pouvant être définis sont DM_IN_PROMPT (ou DM_PROMPT), DM_ADVANCED, DM_NOPERMISSION et DM_OUT_BUFFER (ou DM_COPY).
Si la valeur reçue pour le paramètre pPSUIInfo est NULL, le spouleur d’impression appelle directement la fonction, sans passer par CPSUI. Dans ce cas, le paramètre lParam contient l’adresse d’une structure DOCUMENTPROPERTYHEADER, et les règles suivantes s’appliquent :
Si le membre fMode de la structure DOCUMENTPROPERTYHEADER est égal à zéro, ou si le membre pdmOut de la même structure est NULL, la fonction doit retourner uniquement la taille totale de la structure DEVMODEW de l’imprimante, y compris les membres de structure publique et privée, dans le membre cbOut de la structure DOCUMENTPROPERTYHEADER.
Si le membre fMode de la structure DOCUMENTPROPERTYHEADER n’est pas égal à zéro, la fonction doit effectuer les opérations indiquées par les indicateurs fMode. Les seuls indicateurs pouvant être définis sont DM_IN_BUFFER (ou DM_MODIFY) et DM_OUT_BUFFER (ou DM_COPY).
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | winddiui.h (include Winddiui.h) |