Funzione di callback LPPAGEPAINTHOOK (commdlg.h)

  • Articolo

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

PAGESETUPDLG

PageSetupDlg

Riferimento