GetDlgItem

La funzione GetDlgItem recupera l'handle di un controllo nella finestra di dialogo specificata.

(HWND GetDlgItem HWND  hDlg, / / handle di finestra di dialogointnIDDlgItem / / identificatore del controllo);
 

Parametri

hDlg
Identifica la finestra di dialogo che contiene il controllo.
nIDDlgItem
Specifica l'identificatore del controllo da recuperare.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è l'handle del controllo specificato.

Se la funzione ha esito negativo, il valore restituito è NULL, che indica un handle di casella di dialogo non valido o un controllo inesistente. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

È possibile utilizzare la funzione GetDlgItem con qualsiasi coppia di finestra padre-figlio, non solo con le finestre di dialogo. Fino a quando il parametro hDlg specifica una finestra padre e finestra figlio ha un identificatore univoco (come specificato dal parametro hMenu nella funzione CreateWindow o CreateWindowEx che ha creato la finestra figlio), GetDlgItem restituisce un handle valido alla finestra figlio.

Windows CE: La funzione GetDlgItem funziona solo per i controlli figlio immediato di una finestra di dialogo — non eseguirà la ricerca attraverso le finestre di dialogo nidificati.

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.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella funzioni, CreateWindow, CreateWindowEx, GetDlgItemInt, GetDlgItemText

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

Index