Structure DEVNAMES (commdlg.h)

  • Article

Contient des chaînes qui identifient les noms de pilotes, de périphériques et de ports de sortie d’une imprimante. Ces chaînes doivent être des chaînes ANSI lorsque la version ANSI de PrintDlg ou PrintDlgEx est utilisée, et doivent être des chaînes Unicode lorsque la version Unicode de PrintDlg ou PrintDlgEx est utilisée. Les fonctions PrintDlgEx et PrintDlg utilisent ces chaînes pour initialiser la feuille de propriétés d’impression définie par le système ou la boîte de dialogue Imprimer. Lorsque l’utilisateur ferme la feuille de propriétés ou la boîte de dialogue, des informations sur l’imprimante sélectionnée sont retournées dans cette structure.

Syntaxe

typedef struct tagDEVNAMES {
  WORD wDriverOffset;
  WORD wDeviceOffset;
  WORD wOutputOffset;
  WORD wDefault;
} DEVNAMES;

Membres

wDriverOffset

Type : WORD

Décalage, en caractères, du début de cette structure à une chaîne terminée par null qui contient le nom de fichier (sans l’extension) du pilote de périphérique. Lors de l’entrée, cette chaîne est utilisée pour déterminer l’imprimante à afficher initialement dans la boîte de dialogue.

wDeviceOffset

Type : WORD

Décalage, en caractères, du début de cette structure à la chaîne null qui contient le nom de l’appareil.

wOutputOffset

Type : WORD

Décalage, en caractères, du début de cette structure à la chaîne terminée par null qui contient le nom de l’appareil pour le support de sortie physique (port de sortie).

wDefault

Type : WORD

Indique si les chaînes contenues dans la structure DEVNAMES identifient l’imprimante par défaut. Cette chaîne permet de vérifier que l’imprimante par défaut n’a pas changé depuis la dernière opération d’impression. Si l’une des chaînes ne correspond pas, un message d’avertissement s’affiche pour informer l’utilisateur que le document peut avoir besoin d’être reformaté. Lors de la sortie, le membre wDefault est modifié uniquement si la boîte de dialogue Configuration d’impression s’affiche et que l’utilisateur a choisi le bouton OK . L’indicateur DN_DEFAULTPRN est utilisé si l’imprimante par défaut a été sélectionnée. Si une imprimante spécifique est sélectionnée, l’indicateur n’est pas utilisé. Tous les autres indicateurs de ce membre sont réservés à l’utilisation interne par la procédure de boîte de dialogue de la feuille de propriétés Imprimer ou de la boîte de dialogue Imprimer .

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 commdlg.h (inclure Windows.h)

Voir aussi

Bibliothèque de boîtes de dialogue commune

Conceptuel

PrintDlg

PrintDlgEx

Référence