AdvancedDocumentProperties fonction)

La fonction AdvancedDocumentProperties affiche une boîte de dialogue de configuration de l’imprimante pour l’imprimante spécifiée, ce qui permet à l’utilisateur de configurer cette imprimante.

Cette fonction est un cas particulier de la fonction DocumentProperties . Pour plus d’informations, consultez la section Notes.

Syntaxe

LONG AdvancedDocumentProperties(
  _In_  HWND     hWnd,
  _In_  HANDLE   hPrinter,
  _In_  LPTSTR   pDeviceName,
  _Out_ PDEVMODE pDevModeOutput,
  _In_  PDEVMODE pDevModeInput
);

Paramètres

HWND [ dans]

Handle de la fenêtre parente de la boîte de dialogue de configuration de l’imprimante.

hPrinter [ dans]

Handle d’un objet Printer. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

pDeviceName [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui spécifie le nom de l’appareil pour lequel une boîte de dialogue de configuration de l’imprimante doit être affichée.

pDevModeOutput [ à]

Pointeur vers une structure DEVMODE qui contient les données de configuration spécifiées par l’utilisateur.

pDevModeInput [ dans]

Pointeur vers une structure DEVMODE qui contient les données de configuration utilisées pour initialiser les contrôles de la boîte de dialogue de configuration de l’imprimante.

Valeur retournée

Si la fonction DocumentProperties avec ces paramètres réussit, la valeur de retour de AdvancedDocumentProperties est 1. Sinon, la valeur de retour est zéro.

Remarques

Notes

Il s’agit d’une fonction de blocage ou synchrone qui peut ne pas être renvoyée immédiatement. La vitesse à laquelle cette fonction est retournée dépend des facteurs d’exécution tels que l’état du réseau, la configuration du serveur d’impression et les facteurs d’implémentation des pilotes d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut faire que l’application semble ne pas répondre.

Cette fonction peut uniquement afficher la boîte de dialogue Configuration de l’imprimante pour permettre à un utilisateur de la configurer. Pour plus de contrôle, utilisez DocumentProperties. Les paramètres d’entrée de cette fonction sont passés directement à DocumentProperties et la valeur fMode est définie sur DM _ dans la _ mémoire tampon | DM dans le _ tampon de sortie de l' _ invite | DM _ _ . Contrairement à DocumentProperties, cette fonction retourne uniquement 1 ou 0. Ainsi, vous ne pouvez pas déterminer la taille requise de DEVMODE en affectant à pDevMode la valeur zéro.

Une application peut obtenir le nom désigné par le paramètre pDeviceName en appelant la fonction GetPrinter , puis en examinant le membre pPrinterName de la structure d' informations d’imprimante _ _ 2 .

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel - [Applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server - [Applications de bureau uniquement]
En-tête
Winspool. h (inclure Windows. h)
Bibliothèque
Winspool. lib
DLL
Winspool. drv
Noms Unicode et ANSI
AdvancedDocumentPropertiesW (Unicode) et AdvancedDocumentPropertiesA (ANSI)

Voir aussi

Impression

Fonctions API du spouleur d’impression

AddPrinter

DEVMODE

DocumentProperties

GetPrinter

OpenPrinter

_Infos sur l’imprimante _ 2