Fonction AdvancedDocumentProperties
La fonction AdvancedDocumentProperties affiche une boîte de dialogue de configuration d’imprimante pour l’imprimante spécifiée, ce qui permet à l’utilisateur de configurer cette imprimante.
Cette fonction est un cas spécial de la fonction DocumentProperties . Pour plus d’informations, consultez la section Remarques.
Syntaxe
LONG AdvancedDocumentProperties(
_In_ HWND hWnd,
_In_ HANDLE hPrinter,
_In_ LPTSTR pDeviceName,
_Out_ PDEVMODE pDevModeOutput,
_In_ PDEVMODE pDevModeInput
);
Paramètres
-
hWnd [in]
-
Handle de la fenêtre parente de la boîte de dialogue configuration de l’imprimante.
-
hPrinter [in]
-
Handle pour un objet d’imprimante. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.
-
pDeviceName [in]
-
Pointeur vers une chaîne terminée par null spécifiant le nom de l’appareil pour lequel une boîte de dialogue de configuration d’imprimante doit être affichée.
-
pDevModeOutput [out]
-
Pointeur vers une structure DEVMODE qui contiendra les données de configuration spécifiées par l’utilisateur.
-
pDevModeInput [in]
-
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 configuration de l’imprimante.
Valeur retournée
Si la fonction DocumentProperties avec ces paramètres réussit, la valeur de retour d’AdvancedDocumentProperties est 1. Sinon, la valeur de retour est égale à zéro.
Notes
Notes
Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote 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 donner l’impression que l’application ne répond pas.
Cette fonction peut uniquement afficher la boîte de dialogue de configuration de l’imprimante afin qu’un utilisateur puisse la configurer. Pour plus de contrôle, utilisez DocumentProperties. Les paramètres d’entrée de cette fonction sont transmis directement à DocumentProperties et la valeur fMode est définie sur DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. Contrairement à DocumentProperties, cette fonction retourne uniquement 1 ou 0. Par conséquent, vous ne pouvez pas déterminer la taille requise de DEVMODE en définissant pDevMode sur zéro.
Une application peut obtenir le nom pointé par le paramètre pDeviceName en appelant la fonction GetPrinter , puis en examinant le membre pPrinterName de la structure PRINTER_INFO_2 .
Spécifications
| 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) |