PAGESETUPDLGW, structure (commdlg.h)
Contient des informations sur la fonction PageSetupDlg utilise pour initialiser la boîte de dialogue Mise en page. Une fois que l’utilisateur ferme la boîte de dialogue, le système retourne des informations sur les paramètres de page définis par l’utilisateur dans cette structure.
Syntaxe
typedef struct tagPSDW {
DWORD lStructSize;
HWND hwndOwner;
HGLOBAL hDevMode;
HGLOBAL hDevNames;
DWORD Flags;
POINT ptPaperSize;
RECT rtMinMargin;
RECT rtMargin;
HINSTANCE hInstance;
LPARAM lCustData;
LPPAGESETUPHOOK lpfnPageSetupHook;
LPPAGEPAINTHOOK lpfnPagePaintHook;
LPCWSTR lpPageSetupTemplateName;
HGLOBAL hPageSetupTemplate;
} PAGESETUPDLGW, *LPPAGESETUPDLGW;
Membres
lStructSize
Type : DWORD
Taille, en octets, de cette structure.
hwndOwner
Type : HWND
Handle de la fenêtre propriétaire de la boîte de dialogue. Ce membre peut être n’importe quel handle de fenêtre valide, ou il peut être null si la boîte de dialogue n’a aucun propriétaire.
hDevMode
Type : HGLOBAL
Handle vers un objet de mémoire globale qui contient une structure DEVMODE
hDevNames
Type : HGLOBAL
Handle vers un objet mémoire globale qui contient une structure DEVNAMES. Cette structure contient trois chaînes qui spécifient le nom du pilote, le nom de l’imprimante et le nom du port de sortie. Lors de l’entrée, si un handle est spécifié, les chaînes de la structure DEVNAMES correspondantes sont utilisées pour initialiser des contrôles dans la boîte de dialogue. En sortie, la boîte de dialogue définit hDevNames à un handle de mémoire globale à une structure DEVNAMES qui contient des chaînes spécifiant les sélections de l’utilisateur. Si les sélections de l’utilisateur ne sont pas disponibles, la boîte de dialogue définit hDevNames sur NULL.
Flags
Type : DWORD
Ensemble d’indicateurs de bits que vous pouvez utiliser pour initialiser la boîte de dialogue Mise en page. Lorsque la boîte de dialogue est retournée, elle définit ces indicateurs pour indiquer l’entrée de l’utilisateur. Ce membre peut être une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Définit les valeurs minimales que l’utilisateur peut spécifier pour que les marges de page soient les marges minimales autorisées par l’imprimante. Il s’agit de la valeur par défaut. Cet indicateur est ignoré si les indicateurs PSD_MARGINS et PSD_MINMARGINS sont également spécifiés. |
|
Désactive les contrôles de marge, empêchant l’utilisateur de définir les marges. |
|
Désactive les contrôles d’orientation, empêchant l’utilisateur de définir l’orientation de la page. |
|
Empêche la boîte de dialogue de dessiner le contenu de l’exemple de page. Si vous activez une procédure de PagePaintHook hook, vous pouvez toujours dessiner le contenu de l’exemple de page. |
|
Désactive les contrôles papier, empêchant l’utilisateur de définir des paramètres de page tels que la taille du papier et la source. |
|
Obsolète.
Windows XP/2000 : désactive le bouton Imprimante, empêchant l’utilisateur d’appeler une boîte de dialogue contenant des informations supplémentaires sur la configuration de l’imprimante. |
|
Active la procédure de hook spécifiée dans le membre |
|
Active la procédure de hook spécifiée dans le membre lpfnPageSetupHook. |
|
Indique que les membres hInstance et lpPageSetupTemplateName spécifient un modèle de boîte de dialogue à utiliser à la place du modèle par défaut. |
|
Indique que le membre hPageSetupTemplate identifie un bloc de données qui contient un modèle de boîte de dialogue préchargé. Le système ignore le membre lpPageSetupTemplateName si cet indicateur est spécifié. |
|
Indique que les centièmes de millimètres sont l’unité de mesure pour les marges et la taille du papier. Les valeurs durtMargin |
|
Indique que les millièmes de pouces sont l’unité de mesure pour les marges et la taille du papier. Les valeurs durtMargin |
|
Réservé. |
|
Provoque l’utilisation des valeurs spécifiées dans le rtMargin membre comme largeur initiale pour les marges gauche, supérieure, droite et inférieure. Si PSD_MARGINS n’est pas défini, le système définit les largeurs initiales sur un pouce pour toutes les marges. |
|
Provoque l’utilisation des valeurs spécifiées dans le membre rtMinMargin comme largeurs minimales autorisées pour les marges gauche, supérieure, droite et inférieure. Le système empêche l’utilisateur d’entrer une largeur inférieure à la valeur minimale spécifiée. Si PSD_MINMARGINS n’est pas spécifié, le système définit les largeurs minimales autorisées sur celles autorisées par l’imprimante. |
|
Masque et désactive le bouton Réseau. |
|
Empêche le système d’afficher un message d’avertissement lorsqu’il n’existe aucune imprimante par défaut. |
|
pageSetupDlg n’affiche pas la boîte de dialogue. Au lieu de cela, il définit les membres |
|
Provoque l’affichage de la boîte de dialogue bouton Aide. Le membre |
ptPaperSize
Type : POINT
Dimensions du papier sélectionné par l’utilisateur. L’indicateur PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indique les unités de mesure.
rtMinMargin
Type : RECT
Largeurs minimales autorisées pour les marges gauche, supérieure, droite et inférieure. Le système ignore ce membre si l’indicateur PSD_MINMARGINS n’est pas défini. Ces valeurs doivent être inférieures ou égales aux valeurs spécifiées dans le membre rtMargin. L’indicateur PSD_INTHOUSANDTHSOFINCHES ou PSD_INHUNDREDTHSOFMILLIMETERS indique les unités de mesure.
rtMargin
Type : RECT
Largeurs des marges gauche, supérieure, droite et inférieure. Si vous définissez l’indicateur PSD_MARGINS, rtMargin spécifie les valeurs de marge initiales. Lorsque PageSetupDlg retourne, rtMargin contient les largeurs de marge sélectionnées par l’utilisateur. L’indicateur PSD_INHUNDREDTHSOFMILLIMETERS ou PSD_INTHOUSANDTHSOFINCHES indique les unités de mesure.
hInstance
Type : HINSTANCE
Si l’indicateur
lCustData
Type : LPARAM
Données définies par l’application que le système transmet à la procédure de raccordement identifiée par le membre lpfnPageSetupHook membre. Lorsque le système envoie le message
lpfnPageSetupHook
Type : LPPAGESETUPHOOK
Pointeur vers une procédure de hook PageSetupHook qui peut traiter les messages destinés à la boîte de dialogue. Ce membre est ignoré, sauf si l’indicateur PSD_ENABLEPAGESETUPHOOK est défini dans le membre indicateurs.
lpfnPagePaintHook
Type : LPPAGEPAINTHOOK
Pointeur vers une procédure de hook PagePaintHook qui reçoit WM_PSD_* messages de la boîte de dialogue chaque fois que l’exemple de page est redessiné. En traitant les messages, la procédure de hook peut personnaliser l’apparence de l’exemple de page. Ce membre est ignoré, sauf si l’indicateur
lpPageSetupTemplateName
Type : LPCTSTR
Nom de la ressource de modèle de boîte de dialogue dans le module identifié par le membre hInstance. Ce modèle est remplacé par le modèle de boîte de dialogue standard. Pour les ressources de boîte de dialogue numérotées, lpPageSetupTemplateName peut être une valeur retournée par la macro MAKEINTRESOURCE. Ce membre est ignoré, sauf si l’indicateur de PSD_ENABLEPAGESETUPTEMPLATE est défini dans le membre Indicateurs.
hPageSetupTemplate
Type : HGLOBAL
Si l’indicateur PSD_ENABLEPAGESETUPTEMPLATEHANDLE est défini dans le membre Flags, hPageSetupTemplate est un handle vers un objet mémoire contenant un modèle de boîte de dialogue.
Remarques
Si les indicateurs PSD_INHUNDREDTHSOFMILLIMETERS et PSD_INTHOUSANDTHSOFINCHES ne sont pas spécifiés, le système interroge la valeur LOCALE_IMEASURE des paramètres régionaux utilisateur par défaut pour déterminer l’unité de mesure (centièmes de millimètres ou millièmes de pouces) pour les largeurs de marge et la taille du papier.
Si hDevNames et hDevMode ont des handles valides et que le nom de l’imprimante spécifié par le membre wDeviceOffset de la structure DEVNAMES n’est pas identique au nom spécifié par le membre dmDeviceName de la structure DEVMODE, le système utilise le nom spécifié par wDeviceOffset par défaut.
Note
L’en-tête commdlg.h définit PAGESETUPDLG comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| d’en-tête | commdlg.h (include Windows.h) |
Voir aussi
bibliothèque de boîtes de dialogue courante
conceptuelle
autres ressources
de référence