Funzione di callback DLGPROC (winuser.h)

Articolo
03/13/2024

Funzione di callback definita dall'applicazione usata con le famiglie CreateDialog e DialogBox delle funzioni. Elabora i messaggi inviati a una finestra di dialogo modale o senza modalità. Il tipo DLGPROC definisce un puntatore a questa funzione di callback. DialogProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

DLGPROC Dlgproc;

INT_PTR Dlgproc(
  HWND unnamedParam1,
  UINT unnamedParam2,
  WPARAM unnamedParam3,
  LPARAM unnamedParam4
)
{...}

Parametri

unnamedParam1

Tipo: HWND

Handle per la finestra di dialogo.

unnamedParam2

Tipo: UINT

Messaggio.

unnamedParam3

Tipo: WPARAM

Ulteriori informazioni specifiche del messaggio.

unnamedParam4

Tipo: LPARAM

Ulteriori informazioni specifiche del messaggio.

Tipo: INT_PTR

In genere, la procedura della finestra di dialogo deve restituire TRUE se ha elaborato il messaggio e FALSE se non è stato eseguito. Se la procedura della finestra di dialogo restituisce FALSE, gestione finestre di dialogo esegue l'operazione di dialogo predefinita in risposta al messaggio.

Se la procedura della finestra di dialogo elabora un messaggio che richiede un valore restituito specifico, la procedura della finestra di dialogo deve impostare il valore restituito desiderato chiamando SetWindowLong(hwndDlg, DWL_MSGRESULT, lResult) immediatamente prima di restituire TRUE. Si noti che è necessario chiamare SetWindowLong immediatamente prima di restituire TRUE; in precedenza, il valore DWL_MSGRESULT viene sovrascritto da un messaggio della finestra di dialogo annidato.

I messaggi seguenti sono eccezioni alle regole generali indicate in precedenza. Per informazioni dettagliate sulla semantica del valore restituito, consultare la documentazione relativa al messaggio specifico.

Valore restituito

nessuno

Osservazioni

È consigliabile usare la procedura della finestra di dialogo solo se si usa la classe della finestra di dialogo per la finestra di dialogo. Questa è la classe predefinita e viene usata quando non viene specificata alcuna classe esplicita nel modello della finestra di dialogo. Anche se la procedura della finestra di dialogo è simile a una routine di finestra, non deve chiamare la funzione DefWindowProc per elaborare messaggi indesiderati. I messaggi indesiderati vengono elaborati internamente dalla procedura della finestra di dialogo.

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	winuser.h (include Windows.h)