DialogBoxParam

La funzione DialogBoxParam crea una finestra di dialogo modale da una risorsa modello di finestra di dialogo casella. Prima di visualizzare la finestra di dialogo, la funzione passa un valore definito dall'applicazione della procedura di casella di dialogo come parametro lParam del messaggio WM_INITDIALOG . Un'applicazione può utilizzare questo valore per inizializzare i controlli casella di dialogo.

int (DialogBoxParam HINSTANCE , hInstance, / / handle all'istanza dell'applicazioneLPCTSTRlpTemplateName, / / identifica il modello di finestra di dialogoHWNDhWndParent, / / handle di finestra proprietariaDLGPROClpDialogFunc, / / puntatore alla finestra di dialogo scatola proceduraLPARAMdwInitParam / / valore di inizializzazione);
 

Parametri

hInstance
Identifica un'istanza del modulo cui file eseguibile contiene il modello di finestra di dialogo.
lpTemplateName
Identifica il modello di finestra di dialogo. Questo parametro è il puntatore a una stringa di caratteri con terminazione null che specifica il nome del modello casella di dialogo o un valore integer che specifica l'identificatore di risorsa del modello casella di dialogo. Se il parametro specifica un identificatore di risorsa, la parola di ordine superiore deve essere zero e la parola ordine deve contenere l'identificatore. È possibile utilizzare la macro MAKEINTRESOURCE per creare questo valore.
hWndParent
Identifica la finestra che possiede la finestra di dialogo.
lpDialogFunc
Puntatore alla procedura di casella di dialogo. Per ulteriori informazioni sulla procedura di casella di dialogo, vedere DialogProc.
dwInitParam
Specifica il valore da passare alla finestra di dialogo nel parametro lParam del messaggio WM_INITDIALOG.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è il valore del parametro nResult specificato nella chiamata alla funzione EndDialog utilizzata per chiudere la finestra di dialogo.

Se la funzione ha esito negativo, il valore restituito è – 1. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

La funzione DialogBoxParam utilizza la funzione CreateWindowEx per creare la finestra di dialogo. DialogBoxParam quindi invia un messaggio WM_INITDIALOG (e un messaggio WM_SETFONT) se il modello specifica lo stile DS_SETFONT la procedura di casella di dialogo. La funzione viene visualizzata la finestra di dialogo (a prescindere dal fatto se il modello specifica lo stile WS_VISIBLE), disattiva la finestra proprietaria e inizia il proprio ciclo di messaggi per recuperare e spedire messaggi per la finestra di dialogo.

Quando la procedura di casella di dialogo chiama la funzione EndDialog , DialogBoxParam distrugge la finestra di dialogo, termina il ciclo di messaggi, consente la finestra proprietaria (se abilitato in precedenza) e restituisce il parametro nResult specificato dalla procedura di dialogo casella quando chiamato EndDialog.

Windows 95 e più tardi:Il sistema può supportare un massimo di 255 controlli al modello di finestra di dialogo. Per inserire più di 255 controlli in una finestra di dialogo, creare i controlli nel gestore dei messaggi WM_INITDIALOG anziché collocarli nel modello.

Windows CE: Non tutti gli stili sono supportati nella struttura DLGTEMPLATE nel modello di dialogo cui fa riferimento il parametro lpTemplateName . .

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella funzioni, CreateWindowEx, DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogProc, EndDialog, MAKEINTRESOURCE, WM_INITDIALOG, WM_SETFONT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index