Struttura PAGESETUPDLGA (commdlg.h)

Contiene informazioni utilizzate dalla funzione PageSetupDlg per inizializzare la finestra di dialogo Imposta pagina . Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sui parametri di pagina definiti dall'utente in questa struttura.

Sintassi

typedef struct tagPSDA {
  DWORD           lStructSize;
  HWND            hwndOwner;
  HGLOBAL         hDevMode;
  HGLOBAL         hDevNames;
  DWORD           Flags;
  POINT           ptPaperSize;
  RECT            rtMinMargin;
  RECT            rtMargin;
  HINSTANCE       hInstance;
  LPARAM          lCustData;
  LPPAGESETUPHOOK lpfnPageSetupHook;
  LPPAGEPAINTHOOK lpfnPagePaintHook;
  LPCSTR          lpPageSetupTemplateName;
  HGLOBAL         hPageSetupTemplate;
} PAGESETUPDLGA, *LPPAGESETUPDLGA;

Members

lStructSize

Tipo: DWORD

Dimensione, in byte, della struttura.

hwndOwner

Tipo: HWND

Handle per la finestra proprietaria della finestra di dialogo. Questo membro può essere qualsiasi handle di finestra valido oppure può essere NULL se la finestra di dialogo non ha proprietario.

hDevMode

Tipo: HGLOBAL

Handle per un oggetto memoria globale che contiene una struttura DEVMODE . Se viene specificato un handle, i valori nella struttura DEVMODE corrispondente vengono utilizzati per inizializzare i controlli nella finestra di dialogo. Nell'output la finestra di dialogo imposta hDevMode su un handle di memoria globale su una struttura DEVMODE contenente valori che specificano le selezioni dell'utente. Se le selezioni dell'utente non sono disponibili, la finestra di dialogo imposta hDevMode su NULL.

hDevNames

Tipo: HGLOBAL

Handle per un oggetto memoria globale che contiene una struttura DEVNAMES . Questa struttura contiene tre stringhe che specificano il nome del driver, il nome della stampante e il nome della porta di output. Se viene specificato un handle, le stringhe nella struttura DEVNAMES corrispondente vengono utilizzate per inizializzare i controlli nella finestra di dialogo. Nell'output la finestra di dialogo imposta hDevNames su un handle di memoria globale su una struttura DEVNAMES che contiene stringhe che specificano le selezioni dell'utente. Se le selezioni dell'utente non sono disponibili, la finestra di dialogo imposta hDevNames su NULL.

Flags

Tipo: DWORD

Set di flag di bit che è possibile usare per inizializzare la finestra di dialogo Imposta pagina . Quando la finestra di dialogo viene restituita, imposta questi flag per indicare l'input dell'utente. Questo membro può essere uno o più dei valori seguenti.

ptPaperSize

Tipo: POINT

Dimensioni della carta selezionata dall'utente. Il flag PSD_INTHOUSANDTHSOFINCHES o PSD_INHUNDREDTHSOFMILLIMETERS indica le unità di misura.

rtMinMargin

Tipo: RECT

Larghezza minima consentita per i margini sinistro, superiore, destro e inferiore. Il sistema ignora questo membro se il flag PSD_MINMARGINS non è impostato. Questi valori devono essere minori o uguali ai valori specificati nel membro rtMargin . Il flag PSD_INTHOUSANDTHSOFINCHES o PSD_INHUNDREDTHSOFMILLIMETERS indica le unità di misura.

rtMargin

Tipo: RECT

Larghezze dei margini sinistro, superiore, destro e inferiore. Se si imposta il flag PSD_MARGINS , rtMargin specifica i valori del margine iniziale. Quando PageSetupDlg restituisce, rtMargin contiene le larghezze del margine selezionate dall'utente. Il flag PSD_INHUNDREDTHSOFMILLIMETERS o PSD_INTHOUSANDTHSOFINCHES indica le unità di misura.

hInstance

Tipo: HINSTANCE

Se il flag PSD_ENABLEPAGESETUPTEMPLATE è impostato nel membro Flags , hInstance è un handle per l'applicazione o l'istanza del modulo che contiene il modello di finestra di dialogo denominato dal membro lpPageSetupTemplateName .

lCustData

Tipo: LPARAM

Dati definiti dall'applicazione che il sistema passa alla routine hook identificata dal membro lpfnPageSetupHook . Quando il sistema invia il messaggio WM_INITDIALOG alla routine hook, il parametro lParam del messaggio è un puntatore alla struttura PAGESETUPDLG specificata al momento della creazione del dialogo. La procedura hook può usare questo puntatore per ottenere il valore lCustData .

lpfnPageSetupHook

Tipo: LPPAGESETUPHOOK

Puntatore a una routine hook PageSetupHook in grado di elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGESETUPHOOK non sia impostato nel membro Flags .

lpfnPagePaintHook

Tipo: LPPAGEPAINTHOOK

Puntatore a una routine hook PagePaintHook che riceve messaggi WM_PSD_* dalla finestra di dialogo ogni volta che la pagina di esempio viene ridisegnata. Elaborando i messaggi, la procedura hook può personalizzare l'aspetto della pagina di esempio. Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGEPAINTHOOK non sia impostato nel membro Flags .

lpPageSetupTemplateName

Tipo: LPCTSTR

Nome della risorsa modello della finestra di dialogo nel modulo identificato dal membro hInstance . Questo modello viene sostituito con il modello della finestra di dialogo standard. Per le risorse della finestra di dialogo numerate, lpPageSetupTemplateName può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGESETUPTEMPLATE non sia impostato nel membro Flags .

hPageSetupTemplate

Tipo: HGLOBAL

Se il flag PSD_ENABLEPAGESETUPTEMPLATEHANDLE è impostato nel membro Flags , hPageSetupTemplate è un handle per un oggetto memoria contenente un modello di finestra di dialogo.

Commenti

Se i flag PSD_INHUNDREDTHSOFMILLIMETERS e PSD_INTHOUSANDTHSOFINCHES non vengono specificati, il sistema esegue una query sul valore LOCALE_IMEASURE delle impostazioni locali utente predefinite per determinare l'unità di misura (centesimi di millimetri o millesimi di pollici) per la larghezza del margine e le dimensioni della carta.

Se sia hDevNames che hDevMode hanno handle validi e il nome della stampante specificato dal membro wDeviceOffset della struttura DEVNAMES non corrisponde al nome specificato dal membro dmDeviceName della struttura DEVMODE , il sistema usa il nome specificato da wDeviceOffset per impostazione predefinita.

Requisiti

Vedi anche

Libreria delle finestre di dialogo comuni

Informazioni concettuali

DEVMODE

DEVNAMES

MAKEINTRESOURCE

Altre risorse

PagePaintHook

PageSetupDlg

PageSetupHook

Riferimento

WM_INITDIALOG