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 |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
AdvancedDocumentPropertiesW (Unicode) et AdvancedDocumentPropertiesA (ANSI) |