Struttura PAGESETUPDLGW (commdlg.h)
Contiene informazioni utilizzate dalla funzione PageSetupDlg
Sintassi
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;
Membri
lStructSize
Tipo: DWORD
Dimensione, in byte, di questa 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 dispone di proprietario.
hDevMode
Tipo: HGLOBAL
Handle per un oggetto memoria globale che contiene una struttura di DEVMODE
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. In caso di input, 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 in 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.
Valore | Significato |
---|---|
|
Imposta i valori minimi che l'utente può specificare per i margini della pagina in modo che siano i margini minimi consentiti dalla stampante. Si tratta dell'impostazione predefinita. Questo flag viene ignorato se vengono specificati anche i flag PSD_MARGINS e PSD_MINMARGINS. |
|
Disabilita i controlli margine, impedendo all'utente di impostare i margini. |
|
Disabilita i controlli di orientamento, impedendo all'utente di impostare l'orientamento della pagina. |
|
Impedisce alla finestra di dialogo di disegnare il contenuto della pagina di esempio. Se si abilita una PagePaintHook procedura hook, è comunque possibile disegnare il contenuto della pagina di esempio. |
|
Disabilita i controlli carta, impedendo all'utente di impostare parametri di pagina, ad esempio il formato carta e l'origine. |
|
Obsoleto.
|
|
Abilita la procedura hook specificata nel membro |
|
Abilita la procedura hook specificata nel membro |
|
Indica che i membri hInstance e lpPageSetupTemplateName specificano un modello di finestra di dialogo da usare al posto del modello predefinito. |
|
Indica che il membro hPageSetupTemplate |
|
Indica che i centesimi di millimetri sono l'unità di misura per i margini e le dimensioni della carta. I valori nel rtMargin, rtMinMargine ptPaperSize membri sono in centesimi di millimetri. È possibile impostare questo flag sull'input per eseguire l'override dell'unità di misura predefinita per le impostazioni locali dell'utente. Quando la funzione viene restituita, la finestra di dialogo imposta questo flag per indicare le unità usate. |
|
Indica che i millesimi di pollici sono l'unità di misura per i margini e le dimensioni della carta. I valori nel rtMargin, rtMinMargine membri ptPaperSize sono in millesimi di pollici. È possibile impostare questo flag sull'input per eseguire l'override dell'unità di misura predefinita per le impostazioni locali dell'utente. Quando la funzione viene restituita, la finestra di dialogo imposta questo flag per indicare le unità usate. |
|
Riservato. |
|
Fa in modo che il sistema usi i valori specificati nel membro rtMargin come larghezze iniziali per i margini sinistro, superiore, destro e inferiore. Se PSD_MARGINS non è impostato, il sistema imposta la larghezza iniziale su un pollice per tutti i margini. |
|
Fa sì che il sistema usi i valori specificati nel membro rtMinMargin come larghezza minima consentita per i margini sinistro, superiore, destro e inferiore. Il sistema impedisce all'utente di immettere una larghezza minore del valore minimo specificato. Se PSD_MINMARGINS non viene specificato, il sistema imposta le larghezze minime consentite a quelle consentite dalla stampante. |
|
Nasconde e disabilita il pulsante network |
|
Impedisce al sistema di visualizzare un messaggio di avviso quando non è presente alcuna stampante predefinita. |
|
PageSetupDlg non visualizza la finestra di dialogo. Imposta invece i membri hDevNames |
|
Fa sì che la finestra di dialogo visualizzi il pulsante guida |
ptPaperSize
Tipo: POINT
Dimensioni della carta selezionata dall'utente. Il flag PSD_INTHOUSANDTHSOFINCHES o PSD_INHUNDREDTHSOFMILLIMETERS indica le unità di misura.
rtMinMargin
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
rtMargin
Larghezze dei margini sinistro, superiore, destro e inferiore. Se si imposta il flag di PSD_MARGINS, rtMargin specifica i valori iniziali del margine. Quando pageSetupDlg restituisce, rtMargin contiene le larghezze dei margini selezionate dall'utente. Il flag PSD_INHUNDREDTHSOFMILLIMETERS o PSD_INTHOUSANDTHSOFINCHES indica le unità di misura.
hInstance
Tipo: HINSTANCE
Se il flag
lCustData
Tipo: LPARAM
Dati definiti dall'applicazione passati dal sistema alla routine hook identificata dal membro lpfnPageSetupHook. Quando il sistema invia il messaggio di 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
lpfnPageSetupHook
Tipo: LPPAGESETUPHOOK
Puntatore a un PageSetupHook routine hook in grado di elaborare i messaggi destinati alla finestra di dialogo. Questo membro viene ignorato a meno che il flag di
lpfnPagePaintHook
Tipo: LPPAGEPAINTHOOK
Puntatore a un PagePaintHook routine hook che riceve WM_PSD_* messaggi dalla finestra di dialogo ogni volta che viene ridisegnata la pagina di esempio. Elaborando i messaggi, la procedura hook può personalizzare l'aspetto della pagina di esempio. Questo membro viene ignorato a meno che il flag di
lpPageSetupTemplateName
Tipo: LPCTSTR
Nome della risorsa modello della finestra di dialogo nel modulo identificato dal membro
hPageSetupTemplate
Tipo: HGLOBAL
Se il flag
Osservazioni
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 entrambi
Nota
L'intestazione commdlg.h definisce PAGESETUPDLG come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
Requisito | Valore |
---|---|
client minimo supportato | Windows 2000 Professional [solo app desktop] |
server minimo supportato | Windows 2000 Server [solo app desktop] |
intestazione |
commdlg.h (include Windows.h) |
Vedere anche
della libreria delle finestre di dialogo comuni
concettuale
altre risorse
riferimento