Architettura dell'anteprima di stampa
In questo articolo viene illustrata l'implementazione della funzionalità di anteprima di stampa del framework MFC. Gli argomenti trattati includono:
L'anteprima di stampa è piuttosto diversa dalla visualizzazione e dalla stampa di una schermata perché, anziché disegnare direttamente un'immagine in un dispositivo, l'applicazione deve simulare la stampante utilizzando lo schermo. A tale scopo, microsoft Foundation Class Library definisce una classe speciale (non documentata) derivata dalla classe CDC, denominata CPreviewDC. Tutti gli oggetti CDC contengono due contesti di periferica, ma in genere sono identici. In un CPreviewDC oggetto sono diversi: il primo rappresenta la stampante simulata e il secondo rappresenta lo schermo in cui viene effettivamente visualizzato l'output.
Processo di anteprima di stampa
Quando l'utente seleziona il comando Anteprima di stampa dal menu File , il framework crea un CPreviewDC oggetto. Ogni volta che nell'applicazione viene eseguita un'operazione che imposta una caratteristica del contesto della stampante, viene eseguita dal framework un'operazione simile nel contesto dello schermo. Ad esempio, se nell'applicazione viene selezionato un tipo di carattere per la stampa, dal framework viene selezionato un tipo di carattere per la visualizzazione su schermo che simula il tipo di carattere della stampante. Ogni volta che dall'applicazione l'output viene inviato alla stampante, dal framework viene inviato l'output allo schermo.
L'anteprima di stampa è differente dalla stampa nell'ordine di disegno delle pagine di un documento. Durante la stampa, il framework continua un ciclo di stampa fino al completamento del rendering di un determinato intervallo di pagine. Durante l'anteprima di stampa, vengono visualizzate una o due pagine in qualsiasi momento e quindi l'applicazione resta in attesa; non viene visualizzata alcun'altra pagina finché l'utente non risponde. Durante l'anteprima di stampa, l'applicazione deve anche rispondere a WM_PAINT messaggi, proprio come durante la visualizzazione normale dello schermo.
La funzione CView::OnPreparePrinting viene chiamata quando viene richiamata la modalità di anteprima, proprio come all'inizio di un processo di stampa. La struttura CPrintInfo passata alla funzione contiene diversi membri i cui valori è possibile impostare per regolare determinate caratteristiche dell'operazione di anteprima di stampa. Ad esempio, è possibile impostare il membro m_nNumPreviewPages per specificare se si desidera visualizzare l'anteprima del documento in modalità una pagina o due pagine.
Modifica dell'anteprima di stampa
È possibile modificare il comportamento e l'aspetto dell'anteprima di stampa in varie modalità in modo piuttosto semplice. Ad esempio, è possibile, tra le altre cose:
Fare in modo che la finestra dell'anteprima di stampa visualizzi una barra di scorrimento per semplificare l'accesso a qualsiasi pagina del documento.
Fare in modo che l'anteprima di stampa mantenga la posizione dell'utente nel documento da cui iniziare la visualizzazione dalla pagina corrente.
Fare in modo che l'inizializzazione possa essere eseguita in modo differente per l'anteprima di stampa e per la stampa.
Fare in modo che l'anteprima di stampa visualizzi i numeri di pagina con il proprio formato personalizzato.
Se si conosce la lunghezza del documento e si chiama SetMaxPage con il valore appropriato, il framework può utilizzare questa informazione nella modalità anteprima nonché durante la stampa. Una volta che il framework conosce la lunghezza del documento, può fornire alla finestra di anteprima una barra di scorrimento, consentendo all'utente di scorrere avanti e indietro il documento nella modalità di anteprima. Se non è stata impostata la lunghezza del documento, il framework non può posizionare la barra di scorrimento per indicare la posizione corrente, quindi non aggiunge una barra di scorrimento. In questo caso, l'utente deve utilizzare i pulsanti Pagina successiva e Pagina precedente nella barra di controllo della finestra dell'anteprima per scorrere il documento.
Per l'anteprima di stampa, può risultare utile assegnare un valore al membro m_nCurPage di CPrintInfo, anche se non lo si farebbe mai per la stampa normale. Durante la stampa comune, il membro trasmette informazioni dal framework alla classe di visualizzazione. In questo modo il framework indica alla visualizzazione quale pagina deve essere stampata.
Al contrario, all'avvio della modalità anteprima di stampa, il membro m_nCurPage contiene informazioni nella direzione opposta: dalla visualizzazione al framework. Il framework utilizza il valore di questo membro per determinare quale pagina deve essere visualizzata in anteprima per prima. Il valore predefinito di questo membro è 1, in questo modo viene inizialmente visualizzata la prima pagina del documento. È possibile eseguire l'override di OnPreparePrinting per impostare il membro sul numero di pagina che viene visualizzato nel momento in cui il comando Anteprima di stampa è stato richiamato. In questo modo, l'applicazione mantiene la posizione corrente dell'utente quando si sposta dalla modalità di visualizzazione normale alla modalità anteprima di stampa.
In alcuni casi è necessario che OnPreparePrinting esegua differenti inizializzazioni a seconda che venga chiamato per un processo di stampa o per l'anteprima di stampa. È possibile determinare questo problema esaminando la variabile membro m_bPreview nella CPrintInfo struttura. Questo membro è impostato su TRUE quando viene richiamata l'anteprima di stampa.
La CPrintInfo struttura contiene anche un membro denominato m_strPageDesc, che viene usato per formattare le stringhe visualizzate nella parte inferiore della schermata in modalità a pagina singola e a più pagine. Per impostazione predefinita, queste stringhe sono nel formato "Page n" e "Pages n - m", ma è possibile modificare m_strPageDesc dall'interno OnPreparePrinting e impostare le stringhe su un valore più elaborato. Per altre informazioni, vedere CPrintInfo Structure (Struttura CPrintInfo) in MFC Reference (Informazioni di riferimento su MFC).