Funzione GetDlgItem (winuser.h)

Articolo
03/13/2024

Recupera un handle in un controllo nella finestra di dialogo specificata.

Sintassi

HWND GetDlgItem(
  [in, optional] HWND hDlg,
  [in]           int  nIDDlgItem
);

Parametri

[in, optional] hDlg

Tipo: HWND

Handle della finestra di dialogo contenente il controllo.

[in] nIDDlgItem

Tipo: int

Identificatore del controllo da recuperare.

Valore restituito

Tipo: HWND

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

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

Commenti

È possibile usare la funzione GetDlgItem con qualsiasi coppia di finestre padre-figlio, non solo con le finestre di dialogo. Se il parametro hDlg specifica una finestra padre e la 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 nella finestra figlio.

Esempio

Per un esempio, vedere Inizializzazione di una 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)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introdotto in Windows 8)