Funzione GetDlgCtrlID (winuser.h)
Recupera l'identificatore del controllo specificato.
Sintassi
int GetDlgCtrlID(
[in] HWND hWnd
);
Parametri
[in] hWnd
Tipo: HWND
Handle per il controllo.
Valore restituito
Tipo: int
Se la funzione ha esito positivo, il valore restituito è l'identificatore del controllo.
Se la funzione ha esito negativo, il valore restituito è zero. Un valore non valido per il parametro hwndCtl , ad esempio, causerà l'esito negativo della funzione. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
GetDlgCtrlID accetta handle di finestre figlio e handle di controlli nelle finestre di dialogo. Un'applicazione imposta l'identificatore per una finestra figlio quando crea la finestra assegnando il valore dell'identificatore al parametro hmenu quando si chiama la funzione CreateWindow o CreateWindowEx.
Anche se GetDlgCtrlID può restituire un valore se hwndCtl è un handle in una finestra di primo livello, le finestre di primo livello non possono avere identificatori e tale valore restituito non è mai valido.
Esempio
Per un esempio, vedere Inizializzazione di una finestra di dialogo.
Requisiti
| 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) |
Vedi anche
Informazioni concettuali
Riferimento