PAGESETUPDLG

La struttura PAGESETUPDLG contiene informazioni che la funzione PageSetupDlg viene utilizzata per inizializzare il Page Setup comune nella finestra di dialogo. Dopo che l'utente chiude la finestra di dialogo, il sistema restituisce informazioni sui parametri definiti dall'utente pagina in questa struttura.

typedef struct tagPSD {/ / psd DWORD lStructSize; 
    HWND hwndOwner; 
    HGLOBAL hDevMode; 
    HGLOBAL hDevNames; 
    DWORD Flags; 
    PUNTO ptPaperSize; 
    RECT rtMinMargin; 
    RECT rtMargin; 
    HINSTANCE hInstance; 
    LPARAM lCustData; 
    LPPAGESETUPHOOK lpfnPageSetupHook; 
    LPPAGEPAINTHOOK lpfnPagePaintHook; 
    LPCTSTR lpPageSetupTemplateName; 
    HGLOBAL hPageSetupTemplate; 
} PAGESETUPDLG, * LPPAGESETUPDLG 
 

Membri

lStructSize
Specifica la dimensione, in byte, di questa struttura.
hwndOwner
Identifica la finestra che possiede la finestra di dialogo. Questo membro può essere alcun handle di finestra valido, oppure può essere NULL se la finestra di dialogo non ha alcun proprietario.
hDevMode
Handle per un oggetto di memoria globale che contiene un struttura DEVMODE . In input, se viene data una maniglia, i valori nella struttura DEVMODE corrispondente vengono utilizzati per inizializzare i controlli nella finestra di dialogo. In uscita, la finestra di dialogo cofanetti hDevMode a un handle di memoria globale per una struttura DEVMODE che contiene valori che specificano le selezioni dell'utente. Se selezioni dell'utente non sono disponibili, nella finestra di dialogo Imposta hDevMode su NULL.
hDevNames
Handle per un oggetto memoria globale che contiene una struttura DEVNAMES . Questa struttura contiene tre stringhe che specifica il nome del driver, il nome della stampante e il nome di porta di uscita. In input, se un handle è dato, le stringhe nella struttura DEVNAMES corrispondente vengono utilizzate per inizializzare i controlli nella finestra di dialogo. In uscita, la finestra di dialogo cofanetti hDevNames a un handle di memoria globale per una struttura DEVNAMES contenente stringhe specificando le selezioni dell'utente. Se selezioni dell'utente non sono disponibili, nella finestra di dialogo Imposta hDevNames su NULL.
Bandiere
Un insieme di flag di bit che è possibile utilizzare per inizializzare la Page Setup comune nella finestra di dialogo. Quando ritorna nella finestra di dialogo, imposta questi flag per indicare l'input dell'utente. Questo membro può essere una combinazione dei seguenti flag:
PSD_DEFAULTMINMARGINS
Imposta i valori minimi che l'utente può specificare per i margini di pagina essere i margini minimi consentiti dalla stampante. Questa è l'impostazione predefinita. Questo flag viene ignorato se i flag PSD_MARGINS e PSD_MINMARGINS sono anche specificati.
PSD_DISABLEMARGINS
Disattiva i controlli margine, impedendo all'utente di impostare i margini.
PSD_DISABLEORIENTATION
Disattiva i controlli orientamento, impedendo all'utente di impostare l'orientamento della pagina.
PSD_DISABLEPAGEPAINTING
Nella finestra di dialogo impedisce che il contenuto della pagina di esempio di disegno. Se si abilita una routine di hook PagePaintHook , è ancora possibile disegnare il contenuto della pagina di esempio.
PSD_DISABLEPAPER
Disattiva i controlli di carta, impedendo all'utente di impostare parametri di pagina, ad esempio il formato della carta e la fonte.
PSD_DISABLEPRINTER
Disattiva il pulsante stampante , impedendo all'utente di richiamare una finestra di dialogo che contiene informazioni sull'installazione di stampante supplementari.
PSD_ENABLEPAGEPAINTHOOK
Consente la routine di hook specificata nel membro lpfnPagePaintHook.
PSD_ENABLEPAGESETUPHOOK
Consente la routine di hook specificata nel membro lpfnPageSetupHook.
PSD_ENABLEPAGESETUPTEMPLATE
Indica che i membri hInstance e lpPageSetupTemplateName specificano un modello di finestra di dialogo da utilizzare al posto del modello predefinito.
PSD_ENABLEPAGESETUPTEMPLATEHANDLE
Indica che il membro hPageSetupTemplate identifica un blocco di dati che contiene un modello di finestra di dialogo precaricati. Il sistema ignora il membro lpPageSetupTemplateName se questo flag viene specificato.
PSD_INHUNDREDTHSOFMILLIMETERS
Indica che centesimi di millimetro sono l'unità di misura per i margini e dimensioni di carta. I valori nei membri rtMargin, rtMinMargine ptPaperSize sono in centesimi di millimetro. È possibile impostare questo flag in input per eseguire l'override di unità di misura per le impostazioni internazionali dell'utente predefinito. Quando la funzione termina, il box di dialogo set questo flag per indicare le unità utilizzato.
PSD_INTHOUSANDTHSOFINCHES
Indica che i millesimi di pollici sono l'unità di misura per i margini e dimensioni di carta. I valori nei membri rtMargin, rtMinMargine ptPaperSize sono in millesimi di pollici. È possibile impostare questo flag in input per eseguire l'override di unità di misura per le impostazioni internazionali dell'utente predefinito. Quando la funzione termina, il box di dialogo set questo flag per indicare le unità utilizzato.
PSD_INWININIINTLMEASURE
Non implementata.
PSD_MARGINS
Induce il sistema a utilizzare i valori specificati nel membro rtMargin come la larghezza iniziale per la sinistra, alto, destra e margini di fondo. Se PSD_MARGINS non è impostato, il sistema imposta la larghezza iniziale un pollice per tutti i margini.
PSD_MINMARGINS
Induce il sistema a utilizzare i valori specificati nel membro rtMinMargin come le larghezze minime ammissibili per la sinistra, alto, destra e margini di fondo. Il sistema impedisce all'utente di entrare in una larghezza che è inferiore al minimo specificato. Se non è specificato PSD_MINMARGINS, il sistema imposta le larghezze minime ammissibili a quelle consentite dalla stampante.
PSD_NONETWORKBUTTON
Nasconde e disabilita il pulsante rete.
PSD_NOWARNING
Impedisce la visualizzazione di un messaggio di avviso quando non non c'è alcuna stampante predefinita del sistema.
PSD_RETURNDEFAULT
PageSetupDlg non viene visualizzata la finestra di dialogo. Invece, imposta i membri hDevNames e hDevMode alle maniglie a strutture DEVMODE e DEVNAMES che vengono inizializzate per la stampante predefinita del sistema. PageSetupDlg restituisce un errore se hDevMode o hDevNames non è NULL.
PSD_SHOWHELP
Provoca la finestra di dialogo visualizzare il pulsante Help . Il membro hwndOwner deve specificare la finestra per ricevere il HELPMSGSTRING registrati messaggi inviati nella finestra di dialogo quando l'utente fa clic sul pulsante Guida.

ptPaperSize
Specifica le dimensioni della carta selezionata dall'utente. Il flag PSD_INTHOUSANDTHSOFINCHES o PSD_INHUNDREDTHSOFMILLIMETERS indica le unità di misura.
rtMinMargin
Specifica le larghezze minime ammissibili per la sinistra, alto, destra e margini di fondo. Il sistema ignora questo membro se non è impostato il flag PSD_MINMARGINS. Tali valori devono essere inferiore o uguale ai valori specificati nel membro rtMargin . Il flag PSD_INTHOUSANDTHSOFINCHES o PSD_INHUNDREDTHSOFMILLIMETERS indica le unità di misura.
rtMargin
Specifica la larghezza di sinistra, alto, destra e i margini inferiore. Se si imposta il flag PSD_MARGINS, rtMargin specifica i valori del margine iniziale. Quando PageSetupDlg restituisce, rtMargin contiene le larghezze di margine selezionate dall'utente. Il flag PSD_INHUNDREDTHSOFMILLIMETERS o PSD_INTHOUSANDTHSOFINCHES indica le unità di misura.
hInstance
Se nel membro flag è impostato il flag PSD_ENABLEPAGESETUPTEMPLATE, hInstance è l'handle dell'applicazione o istanza di modulo che contiene il modello di finestra di dialogo denominato dal membro lpPageSetupTemplateName.
lCustData
Specifica i dati definiti dall'applicazione che il sistema passa alla routine di hook identificata dal membro lpfnPageSetupHook . Quando il sistema invia il messaggio WM_INITDIALOG per la routine di hook, parametro lParam del messaggio è che un puntatore alla struttura PAGESETUPDLG specificato quando fu creata la finestra di dialogo. La routine di hook può utilizzare questo puntatore per ottenere il valore di lCustData.
lpfnPageSetupHook
Puntatore a un PageSetupHook gancio procedura che consente di elaborare i messaggi destinati a nella finestra di dialogo. Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGESETUPHOOK è impostato nel membro flag.
lpfnPagePaintHook
Puntatore a un PagePaintHook gancio procedura che riceve WM_PSD_ * messaggi nella finestra di dialogo ogni volta che la pagina di esempio viene ridisegnata. Elaborando i messaggi, la routine di hook possibile personalizzare l'aspetto della pagina di esempio. Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGEPAINTHOOK è impostato nel membro flag.
lpPageSetupTemplateName
Puntatore a una stringa con terminazione null che assegna la risorsa modello di finestra casella nel modulo identificato dal membro hInstance . Questo modello viene sostituito con il modello di finestra di dialogo standard. Per le risorse di casella di dialogo numerati, lpPageSetupTemplateName può essere un valore restituito dalla macro MAKEINTRESOURCE . Questo membro viene ignorato a meno che il flag PSD_ENABLEPAGESETUPTEMPLATE è impostato nel membro flag.
hPageSetupTemplate
Se nel membro flag è impostato il flag PSD_ENABLEPAGESETUPTEMPLATEHANDLE, hPageSetupTemplate è l'handle di un oggetto di memoria contenente un modello di finestra di dialogo.

Osservazioni

Se non viene specificato il flag PSD_INHUNDREDTHSOFMILLIMETERS e PSD_INTHOUSANDTHSOFINCHES, il sistema query il valore LOCALE_IMEASURE di impostazioni locali dell'utente predefinito per determinare l'unità di misura (centesimi di millimetro) oppure millesimi di pollici per il margine larghezze e il formato della carta.

Se hDevNames hDevMode che sia valido maniglie e il nome della stampante specificato dal membro della struttura DEVNAMES wDeviceOffset non è la stessa come nome specificato dal membro dmDeviceName della struttura DEVMODE , il sistema utilizza il nome specificato da wDeviceOffset per impostazione predefinita.

Descrizione

nbsp; Windows &NT: richiede 3,51 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in commdlg.h.
Unicode:Definito come strutture di Unicode e ANSI.

Vedi anche

Comune di dialogo casella libreria panoramica, strutture di Box di dialogo comuni, DEVMODE, DEVNAMES, MAKEINTRESOURCE, PagePaintHook, PageSetupDlg, PageSetupHook, WM_INITDIALOG

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index