Structure PAGESETUPDLGW (commdlg.h)

Contient des informations que 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 qui possède la boîte de dialogue. Ce membre peut être n’importe quel handle de fenêtre valide, ou il peut avoir la valeur NULL si la boîte de dialogue n’a pas de propriétaire.

hDevMode

Type : HGLOBAL

Handle d’un objet de mémoire globale qui contient une structure DEVMODE . En entrée, si un handle est spécifié, les valeurs de la structure DEVMODE correspondante sont utilisées pour initialiser les contrôles dans la boîte de dialogue. Lors de la sortie, la boîte de dialogue définit hDevMode sur un handle de mémoire globale sur une structure DEVMODE qui contient des valeurs 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 hDevMode sur NULL.

hDevNames

Type : HGLOBAL

Handle vers un objet de 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. En entrée, si un handle est spécifié, les chaînes de la structure DEVNAMES correspondante sont utilisées pour initialiser des contrôles dans la boîte de dialogue. À la sortie, la boîte de dialogue définit hDevNames sur un handle de mémoire globale sur 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 retourne, elle définit ces indicateurs pour indiquer l’entrée de l’utilisateur. Ce membre peut être une ou plusieurs des valeurs suivantes.

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 PSD_ENABLEPAGESETUPTEMPLATE est défini dans le membre Flags, hInstance est un handle de l’application ou du module instance qui contient le modèle de boîte de dialogue nommé par le membre lpPageSetupTemplateName.

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 . Lorsque le système envoie le message WM_INITDIALOG à la procédure de raccordement, le paramètre lParam du message est un pointeur vers la structure PAGESETUPDLG spécifiée lors de la création du dialogue. La procédure de raccordement peut utiliser ce pointeur pour obtenir la valeur lCustData .

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 des messages WM_PSD_* de la boîte de dialogue chaque fois que l’exemple de page est redessiné. En traitant les messages, la procédure de raccordement peut personnaliser l’apparence de l’exemple de page. Ce membre est ignoré, sauf si l’indicateur PSD_ENABLEPAGEPAINTHOOK est défini dans le membre Indicateurs .

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 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 pour un objet mémoire contenant un modèle de boîte de dialogue.

Remarques

Si les indicateurs de PSD_INHUNDREDTHSOFMILLIMETERS et de PSD_INTHOUSANDTHSOFINCHES ne sont pas spécifiés, le système interroge la valeur de 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 le format de papier.

Si hDevNames et hDevMode ont des handles valides et que le nom d’imprimante spécifié par le membre wDeviceOffset de la structure DEVNAMES n’est pas le même que celui spécifié par le membre dmDeviceName de la structure DEVMODE , le système utilise le nom spécifié par wDeviceOffset par défaut.

Configuration requise

Voir aussi

Bibliothèque de boîtes de dialogue commune

Conceptuel

DEVMODE

DEVNAMES

MAKEINTRESOURCE

Autres ressources

PagePaintHook

PageSetupDlg

PageSetupHook

Référence

WM_INITDIALOG