Classe di CPrintDialogEx

Articolo
02/19/2013

Incapsula i servizi forniti dalla finestra delle proprietà di stampa di Windows 2000.

class CPrintDialogEx : public CCommonDialog

Membri

Costruttori pubblici

Nome	Descrizione
CPrintDialogEx::CPrintDialogEx	Costruisce un oggetto CPrintDialogEx.

Metodi pubblici

Nome	Descrizione
CPrintDialogEx::CreatePrinterDC	Crea un contesto di dispositivo della stampante senza visualizzare la finestra di dialogo stampa.
CPrintDialogEx::DoModal	Visualizzare la finestra di dialogo e sarà che l'utente disponga delle selezioni.
CPrintDialogEx::GetCopies	Recupera il numero di copie richieste.
CPrintDialogEx::GetDefaults	Recupera le impostazioni predefinite del dispositivo senza visualizzare una finestra di dialogo.
CPrintDialogEx::GetDeviceName	Recupera il nome di dispositivo di stampa attualmente selezionato.
CPrintDialogEx::GetDevMode	Recuperare la struttura DEVMODE.
CPrintDialogEx::GetDriverName	Recupera il nome del driver di dispositivo definito dal sistema della stampante.
CPrintDialogEx::GetPortName	Recupera il nome della porta della stampante selezionata.
CPrintDialogEx::GetPrinterDC	Recupera l'handle al contesto di dispositivo della stampante.
CPrintDialogEx::PrintAll	Determina se visualizzare tutte le pagine del documento.
CPrintDialogEx::PrintCollate	Determina se le copie confrontate sono necessarie.
CPrintDialogEx::PrintCurrentPage	Determina se stampare la pagina corrente del documento.
CPrintDialogEx::PrintRange	Determina se stampare solo un determinato intervallo di pagine.
CPrintDialogEx::PrintSelection	Determina se stampare solo gli elementi attualmente selezionato.

Membri dati pubblici

Nome	Descrizione
CPrintDialogEx::m_pdex	Una struttura utilizzata per personalizzare un oggetto CPrintDialogEx.

Note

È possibile utilizzare il framework per gestire molti aspetti del processo di stampa per l'applicazione.Per ulteriori informazioni sull'utilizzo del framework per gestire le attività di stampa, vedere l'articolo stampa.

Se si desidera che l'applicazione per gestire la stampa senza la partecipazione del framework, è possibile utilizzare la classe CPrintDialogEx "come è" con il costruttore fornito, oppure è possibile derivare la classe della finestra di dialogo da CPrintDialogEx e scrivere un costruttore per esigenze.In entrambi i casi, queste finestre di dialogo e un comportamento simili a finestre di dialogo standard di MFC poiché derivano dalla classe CCommonDialog.

Per utilizzare un oggetto CPrintDialogEx, creare innanzitutto l'oggetto utilizzando il costruttore CPrintDialogEx.Una volta che la finestra di dialogo è stata creata, è possibile impostare o modificare i valori nella struttura m_pdex per inizializzare i valori dei controlli della finestra di dialogo.La struttura m_pdex è di tipo PRINTDLGEX.Per ulteriori informazioni sulla struttura, vedere Windows SDK.

Se non si forniscono le proprie handle in m_pdex per i membri hDevNames e hDevMode, è opportuno chiamare la funzione Windows GlobalFree per queste handle al termine della finestra di dialogo.

Dopo aver inizializzato i controlli finestra di dialogo, chiamare la funzione membro DoModal per visualizzare la finestra di dialogo e per consentire di selezionare le opzioni di stampa.Al termine DoModal, è possibile determinare se l'utente ha scelto OK, applicare, oppure pulsante Annulla.

Se l'utente premesse OK, è possibile utilizzare le funzioni membro di CPrintDialogEx per recuperare l'input di informazioni dall'utente.

La funzione membro CPrintDialogEx::GetDefaults è utile per recuperare le impostazioni predefinite correnti della stampante senza visualizzare una finestra di dialogo.Questo metodo non richiede interazione utente.

È possibile utilizzare la funzione di Windows CommDlgExtendedError per determinare se si è verificato un errore durante l'inizializzazione della finestra di dialogo e per ulteriori informazioni sull'errore.Per ulteriori informazioni su questa funzione, vedere Windows SDK.

Per ulteriori informazioni su l CPrintDialogEx, vedere Classi comuni della finestra di dialogo.