SetupHookProc

Procedura SetupHookProc cârlig este o funcţie de apel invers definite de aplicarea sau definite de biblioteca folosit cu funcţia PrintDlg . Procedura cârlig primeşte mesaje sau notificările destinate pentru procedura caseta de dialog Configurare tipărire comune casetei de dialog de implicit.

Tip LPSETUPHOOKPROC defineşte un indicator pentru această funcţie de apel invers. SetupHookProc este un substituent pentru numele funcţiei definită de aplicarea sau definite de biblioteca.

(UINT SetupHookProc de apel INVERS HWND  hdlg, / / ocupa în fereastra de caseta de dialogUINTuiMsg, / / mesaj identificatorWPARAMwParam, / / mesaj parametruLPARAMlParam / / mesaj parametru);
 

Parametrii

hdlg

Mâner pentru Configurare tipărire comune caseta fereastra de dialog pentru care este destinat mesajul.

uiMsg

Identifică mesajul primite.

wParam

Specifică informaţii suplimentare despre mesajul. Sensul exact depinde de valoarea parametrului uiMsg.

lParam

Specifică informaţii suplimentare despre mesajul. Sensul exact depinde de valoarea parametrului uiMsg.

Valorile întroarse

Dacă procedura cârlig returnează zero, regimul caseta de dialog implicită procesează mesajul.

Dacă procedura cârlig returnează o valoare nenul, regimul caseta de dialog implicită ignoră mesajul.

Observaţii

Caseta de dialog Configurare tipărire a fost înlocuit de caseta de dialog Iniţializare pagină , care să fie utilizate de noi aplicaţii. Cu toate acestea, pentru compatibilitate, funcţia de PrintDlg continuă să sprijine de afişare a casetei de dialog Configurare tipărire . Ave?i posibilitatea să furniza?i o procedură de cârlig SetupHookProc pentru caseta de dialog Configurare tipărire pentru a procesa mesaje sau notificările destinate pentru procedura de caseta de dialog.

Pentru a activa regimul de cârlig, utilizarea PRINTDLG structura care aţi trecut la funcţia de crearea dialog. Specificaţi adresa procedura cârlig membru lpfnSetupHook şi specificaţi pavilion PD_ENABLESETUPHOOK membru steaguri.

Regimul caseta de dialog implicită procesează mesajul WM_INITDIALOG înainte de a trece la regimul cârlig. Pentru toate alte mesaje, procedura cârlig primeşte primul mesaj. Apoi, valoarea returnată de procedura cârlig determină dacă procedura de dialog implicită procesează mesajul sau se ignoră.

Dacă procedura cârlig procesează mesajul WM_CTLCOLORDLG , aceasta trebuie să returneze un mâner de pensulă valabile pentru pictura fundal din caseta de dialog. În general, dacă procedura cârlig procesele orice mesaj WM_CTLCOLOR *, aceasta trebuie să returneze un mâner de pensulă valabile pentru pictura fundal controlului specificat.

Nu apela funcţia EndDialog din procedura de cârlig. În schimb, procedura cârlig puteţi apela funcţia PostMessage pentru a publica un mesaj WM_COMMAND cu valoarea IDABORT la procedura de caseta de dialog. IDABORT de înregistrare se închide caseta de dialog şi provoacă funcţia de caseta de dialog pentru a întoarce FALSE. Dacă aveţi nevoie să ştiţi ce procedura cârlig închis caseta de dialog, trebuie să furnizaţi propriul mecanism de comunicare între procedura cârlig şi aplicaţia.

Puteţi subclasă controalele standard din caseta de dialog comune. Cu toate acestea, procedura comună de caseta de dialog poate, de asemenea, subclasă controalele. Din acest motiv, ar trebui să subclasă controale atunci când procedura dvs. cârlig procesează mesajul WM_INITDIALOG. Acest lucru asigură că vă procedura subclasă primeşte mesajele de control specifice înainte de procedura subclasă prin procedura de caseta de dialog.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în commdlg.h.
Import Biblioteca:Definite de utilizator.

A se vedea, de asemenea

Comune Dialog Box biblioteca prezentare generală, funcţii comune de caseta de Dialog, EndDialog, PrintDlg, PRINTDLG, PostMessage, WM_INITDIALOG, WM_CTLCOLORDLG

Index