Funzione di callback LPPAGEPAINTHOOK (commdlg.h)
Riceve messaggi che consentono di personalizzare il disegno della pagina di esempio nella finestra di dialogo Configurazione pagina . La procedura di hook PagePaintHook è una funzione di callback definita dall'applicazione o definita dalla libreria usata con la funzione PageSetupDlg .
Il tipo LPPAGEPAINTHOOK definisce un puntatore a questa funzione di callback. PagePaintHook è un segnaposto per il nome di funzione definito dall'applicazione o dalla libreria.
Sintassi
LPPAGEPAINTHOOK Lppagepainthook;
UINT_PTR Lppagepainthook(
HWND unnamedParam1,
UINT unnamedParam2,
WPARAM unnamedParam3,
LPARAM unnamedParam4
)
{...}
Parametri
unnamedParam1
Handle nella finestra di dialogo Imposta pagina .
unnamedParam2
Identificatore del messaggio ricevuto.
unnamedParam3
Ulteriori informazioni sul messaggio. Il significato esatto dipende dal valore del parametro unnamedParam2 .
unnamedParam4
Ulteriori informazioni sul messaggio. Il significato esatto dipende dal valore del parametro unnamedParam2 .
Valore restituito
Se la procedura di hook restituisce TRUE per uno dei primi tre messaggi di una sequenza di disegno (WM_PSD_PAGESETUPDLG, WM_PSD_FULLPAGERECT o WM_PSD_MINMARGINRECT), la finestra di dialogo invia non più messaggi e non disegna nella pagina di esempio fino alla successiva volta che il sistema deve ridisegnare la pagina di esempio. Se la procedura di hook restituisce FALSE per tutti e tre i messaggi, la finestra di dialogo invia i messaggi rimanenti della sequenza di disegno.
Se la procedura di hook restituisce TRUE per uno dei messaggi rimanenti in una sequenza di disegno, la finestra di dialogo non disegna la parte corrispondente della pagina di esempio. Se la procedura di hook restituisce FALSE per uno di questi messaggi, la finestra di dialogo disegna tale parte della pagina di esempio.
Commenti
La finestra di dialogo Imposta pagina include un'immagine di una pagina di esempio che mostra come le selezioni dell'utente influiscono sull'aspetto dell'output stampato. L'immagine è costituita da un rettangolo che rappresenta il tipo di carta o busta selezionato, con un rettangolo a linee tratteggiate che rappresenta i margini correnti e i caratteri parziali (testo greco) per mostrare l'aspetto del testo nella pagina stampata. Quando si usa la funzione PageSetupDlg per creare una finestra di dialogo Imposta pagina, è possibile fornire una procedura di hook PagePaintHook per personalizzare l'aspetto della pagina di esempio.
Per abilitare la procedura di hook, usare la struttura PAGESETUPDLG passata alla funzione di creazione. Specificare il puntatore alla procedura di hook nel membro lpfnPagePaintHook e specificare il flag PSD_ENABLEPAGEPAINTHOOK nel membro Flags .
Ogni volta che la finestra di dialogo sta per disegnare il contenuto della pagina di esempio, la procedura di hook riceve i messaggi seguenti nell'ordine in cui sono elencati.
| Messaggio | Significato |
|---|---|
| WM_PSD_PAGESETUPDLG | La finestra di dialogo sta per disegnare la pagina di esempio. La procedura di hook può usare questo messaggio per preparare il contenuto della pagina di esempio. |
| WM_PSD_FULLPAGERECT | La finestra di dialogo sta per disegnare la pagina di esempio. Questo messaggio specifica il rettangolo di selezione della pagina di esempio. |
| WM_PSD_MINMARGINRECT | La finestra di dialogo sta per disegnare la pagina di esempio. Questo messaggio specifica il rettangolo del margine. |
| WM_PSD_MARGINRECT | La finestra di dialogo sta per disegnare il rettangolo del margine. |
| WM_PSD_GREEKTEXTRECT | La finestra di dialogo sta per disegnare il testo greco all'interno del rettangolo del margine. |
| WM_PSD_ENVSTAMPRECT | La finestra di dialogo sta per disegnare nel rettangolo di busta di una pagina di esempio della busta. Questo messaggio viene inviato solo per le buste. |
| WM_PSD_YAFULLPAGERECT | La finestra di dialogo sta per disegnare la parte dell'indirizzo restituito di una pagina di esempio della busta. Questo messaggio viene inviato per buste e altre dimensioni di carta. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | commdlg.h (includere Windows.h) |
Vedi anche
Libreria di finestre di dialogo comuni
Informazioni concettuali
Riferimento