GetDlgCtrlID

La funzione GetDlgCtrlID restituisce l'identificatore del controllo specificato.

int (GetDlgCtrlID HWND  hwndCtl / / handle del controllo);
 

Parametri

hwndCtl
Identifica il controllo.

Valori restituiti

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

Se la funzione ha esito negativo, il valore restituito è zero. Ad esempio, un valore non valido per il parametro hwndCtl , causerà la funzione a fallire. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

GetDlgCtrlID accetta l'handle della finestra figlio, così come le maniglie dei 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 identifica una finestra di primo livello, finestre di primo livello non possono avere identificatori e valore restituito non è valido.

Windows CE: Gli identificatori sono validi solo per finestre figlio.

L'identificatore può essere impostata passandola come parametro hMenu alla funzione CreateWindowEx . Può anche essere impostato ed estratto chiamando le funzioni di GetWindowLong e SetWindowLong con il parametro nIndex impostato su GWL_ID.

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, GetDlgItem

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

Index