Struttura PRINTDLG contiene informazioni che la funzione PrintDlg viene utilizzata per inizializzare la finestra di dialogo stampa . Dopo che l'utente chiude la finestra di dialogo, il sistema utilizza questa struttura per restituire informazioni su selezioni dell'utente.
typedef struct tagPD {/ / pd DWORD lStructSize;
HWND hwndOwner;
GESTIRE hDevMode;
GESTIRE hDevNames;
HDC hDC;
DWORD Flags;
WORD nFromPage;
WORD nToPage;
WORD nMinPage;
WORD nMaxPage;
WORD nCopies;
HINSTANCE hInstance;
DWORD lCustData;
LPPRINTHOOKPROC lpfnPrintHook;
LPSETUPHOOKPROC lpfnSetupHook;
LPCTSTR lpPrintTemplateName;
LPCTSTR lpSetupTemplateName;
GESTIRE hPrintTemplate;
GESTIRE hSetupTemplate;
} PRINTDLG
Se hDevMode è NULL per l'input, PrintDlg alloca memoria per la struttura DEVMODE , Inizializza i suoi membri per indicare l'input dell'utente e restituisce un handle che lo identifica.
Se il driver di periferica per la stampante specificata non supporta la modalità estesa dispositivo, hDevMode è NULL quando restituisce PrintDlg.
Se il nome del dispositivo (specificato dal membro del dmDeviceName la struttura DEVMODE ) non appare nella sezione [dispositivi] della vittoria.INI, PrintDlg restituisce un errore.
Per ulteriori informazioni sui membri hDevMode e hDevNames , vedere la sezione osservazioni alla fine di questo argomento.
Il membro hDevNames può essere NULL, nel qual caso, PrintDlg alloca memoria per la struttura DEVNAMES , Inizializza i suoi membri per indicare all'utente di input, e restituisce un handle che lo identifica.
Per ulteriori informazioni sui membri hDevMode e hDevNames , vedere la sezione osservazioni alla fine di questo argomento.
| PD_ALLPAGES | |
| Il flag predefinito che indica che il pulsante radio tutto inizialmente sia selezionato. Questo flag viene utilizzato come segnaposto per indicare che i flag PD_PAGENUMS e PD_SELECTION non sono specificati. | |
| PD_COLLATE | |
| Se questo flag è impostato, è selezionata la casella di controllo Collate. Se questo flag è impostato quando la funzione PrintDlg restituisce, l'applicazione deve simulare le regole di confronto di più copie. Per ulteriori informazioni, vedere la descrizione del flag PD_USEDEVMODECOPIESANDCOLLATE. |
|
| PD_DISABLEPRINTTOFILE | |
| Consente di disattivare la casella di controllo stampa su File. | |
| PD_ENABLEPRINTHOOK | |
| Consente la routine di hook specificata nel membro lpfnPrintHook . In questo modo la routine di hook per la finestra di dialogo stampa. | |
| PD_ENABLEPRINTTEMPLATE | |
| Indica che i membri hInstance e lpPrintTemplateName specificano un sostituto per il modello predefinito di casella della finestra di dialogo stampa. | |
| PD_ENABLEPRINTTEMPLATEHANDLE | |
| Indica che il membro hPrintTemplate identifica un blocco di dati che contiene un modello di finestra di dialogo precaricati. Questo modello sostituisce il modello predefinito per la finestra di dialogo stampa . Il sistema ignora il membro lpPrintTemplateName se questo flag viene specificato. | |
| PD_ENABLESETUPHOOK | |
| Consente la routine di hook specificata nel membro lpfnSetupHook . In questo modo la routine di hook per la finestra di dialogo Impostazioni di stampa. | |
| PD_ENABLESETUPTEMPLATE | |
| Indica che i membri hInstance e lpSetupTemplateName specificano un sostituto per il modello predefinito di stampa Setup di dialogo casella. | |
| PD_ENABLESETUPTEMPLATEHANDLE | |
| Indica che il membro hSetupTemplate identifica un blocco di dati che contiene un modello di finestra di dialogo precaricati. Questo modello sostituisce il modello predefinito per la finestra di dialogo Impostazioni di stampa . Il sistema ignora il membro lpSetupTemplateName se questo flag viene specificato. | |
| PD_HIDEPRINTTOFILE | |
| Nasconde la casella di controllo stampa su File. | |
| PD_NONETWORKBUTTON | |
| Nasconde e disabilita il pulsante rete. | |
| PD_NOPAGENUMS | |
| Consente di disattivare il pulsante di opzione pagine e i controlli di modifica associato. | |
| PD_NOSELECTION | |
| Disabilita il pulsante di selezione. | |
| PD_NOWARNING | |
| Impedisce che il messaggio di avviso viene visualizzato quando non non c'è alcuna stampante predefinita. | |
| PD_PAGENUMS | |
| Se questo flag è impostato, viene selezionato il pulsante di opzione pagine. Se questo flag è impostato quando la funzione PrintDlg restituisce, i membri di nFromPage e nFromPage indicano l'inizio e la fine di pagine specificate dall'utente. |
|
| PD_PRINTSETUP | |
| Sì che il sistema venga visualizzata la finestra di dialogo Impostazioni stampa anziché la finestra di dialogo stampa. | |
| PD_PRINTTOFILE | |
| Se questo flag è impostato, è selezionata la casella di controllo stampa su File. Se questo flag è impostato quando la funzione PrintDlg restituisce, l'offset indicato dal membro della struttura DEVNAMES wOutputOffset contiene la stringa "FILE:". Quando si chiama il StartDoc funzione per avviare l'operazione di stampa, specificare questo "FILE:" stringa nel membro di lpszOutput i struttura DOCINFO . Specificando questa stringa provoca il sottosistema di stampa eseguire una query dell'utente per il nome del file di output. |
|
| PD_RETURNDC | |
| Cause PrintDlg per restituire un contesto di periferica di corrispondenza le selezioni apportate nella finestra di dialogo dall'utente. Il contesto di periferica viene restituito in hDC. | |
| PD_RETURNDEFAULT | |
| Se questo flag è impostato, la funzione PrintDlg non viene visualizzata nella 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. Sia hDevNames che hDevMode deve essere NULL, o PrintDlg restituisce un errore. Se la stampante predefinita del sistema è supportata da un vecchio driver della stampante (precedenti a Windows versione 3.0), viene restituito solo hDevNames ; hDevMode è NULL. |
|
| PD_RETURNIC | |
| Simile a quella PD_RETURNDC, tranne questo flag restituisce un contesto informazioni piuttosto che in un contesto di periferica. Se viene specificata né PD_RETURNDC né PD_RETURNIC, hDC è indefinito in uscita. | |
| PD_SELECTION | |
| Se questo flag è impostato, viene selezionato il pulsante di selezione. Se è impostata né PD_PAGENUMS né PD_SELECTION, viene selezionato il pulsante di opzione tutte le. |
|
| PD_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. | |
| PD_USEDEVMODECOPIES | |
| Come PD_USEDEVMODECOPIESANDCOLLATE | |
| PD_USEDEVMODECOPIESANDCOLLATE | |
| Questo flag indica se l'applicazione supporta più copie e le regole di confronto. Impostare questo flag in input per indicare che l'applicazione non supporta più copie e le regole di confronto. In questo caso, il nCopies membro della struttura PRINTDLG restituisce sempre 1 e PD_COLLATE mai è impostato nel membro flag. Se questo flag non è impostato, l'applicazione è responsabile per la stampa e la fascicolazione delle copie multiple. In questo caso, il nCopies membro della struttura PRINTDLG indica il numero di copie che l'utente desidera stampare e il flag PD_COLLATE nel membro flag indica se l'utente vuole delle regole di confronto. Indipendentemente dal fatto se questo flag è impostato, un'applicazione in grado di determinare da nCopies e PD_COLLATE quante copie per eseguire il rendering e se stampare li fascicolate. Se questo flag è impostato e il driver della stampante non supporta più copie, viene disattivato il controllo di modifica di copie . Allo stesso modo, se questo flag è impostato e il driver della stampante non supporta le regole di confronto, la casella di controllo Collate è disattivato. I membri di dmCopies e dmCollate i struttura DEVMODE contengono le copie e Fascicola le informazioni utilizzate dal driver della stampante. Se questo flag è impostato e il driver della stampante supporta più copie, il membro dmCopies indica il numero di copie richiesta dall'utente. Se questo flag è impostato e il driver della stampante supporta le regole di confronto, il membro dmCollate della struttura DEVMODE indica se l'utente vuole delle regole di confronto. Se questo flag non è impostato, il membro dmCopies restituisce sempre il 1 e il membro dmCollate è sempre uguale a zero. |
|
Quando ritorna PrintDlg , nFromPage è la pagina iniziale specificata dall'utente. Se il pulsante di opzione pagine è selezionato quando l'utente sceglie il pulsante OK , moda PrintDlg il PD_PAGENUMS bandiera e non tornare fino all'utente immette un valore pagina iniziale che è entro il minimo per un intervallo di pagine massimo.
Windows 95: Se il valore di input per nFromPage o nToPage è compreso nell'intervallo specificato da nMinPage e nMaxPage, PrintDlg restituisce un errore.
Windows NT: Se il valore dell'input per nFromPage o nToPage sono esterno all'intervallo minimo/massimo, PrintDlg restituisce un errore solo se viene specificato il flag PD_PAGENUMS; in caso contrario, verrà visualizzata la finestra di dialogo, ma se si modifica il valore di out-of-range al valore minimo o massimo.
Quando ritorna PrintDlg , nToPage è la pagina finale specificata dall'utente. Se il pulsante di opzione pagine è selezionato quando l'uso clicca il pulsante OK , moda PrintDlg il PD_PAGENUMS bandiera e non tornare fino all'utente immette un valore finale di pagina all'interno del minimo per un intervallo di pagine massimo.
Quando si chiama la funzione PrintDlg , essere sicuri che il membro wDeviceOffset della struttura DEVNAMES è identico al membro del dmDeviceName la struttura DEVMODE . Se questi membri non si specificano la stessa stampante, PrintDlg Inizializza la finestra di dialogo utilizzando la stampante specificata dal membro wDeviceOffset.
In genere, se hDevMode e hDevNames sono NULL, PrintDlg Inizializza la finestra di dialogo utilizzando la stampante predefinita corrente. Tuttavia, se è impostato il flag PD_RETURNDEFAULT e hDevMode e hDevNames sono entrambi NULL, PrintDlg utilizza i membri hDevNames e hDevMode per restituire informazioni sulla stampante predefinita corrente senza visualizzare la finestra di dialogo.
nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winspool.h.
Unicode:Definito come strutture di Unicode e ANSI.
Comune di dialogo casella libreria panoramica, strutture di Box di dialogo comuni, CreateDC, CreateIC, PrintDlg, DEVMODE, DEVNAMES, WM_INITDIALOG
Rimedio: Inserire il CD-ROM CD di MSDN Library.