winuser.h


GetDlgItem

La función GetDlgItem devuelve el manipulador de un control en el cuadro de diálogo especificado.

Sintaxis

HWND GetDlgItem(
    HWND hDlg,      // manipulador del cuadro de diálogo
    int nIDDlgItem  // identificador del control
   ); 

Parámetros:

hDlg: identifica el cuadro de diálogo que contiene el control.

nIDDlgItem: especifica el identificador del control del que se quiere recuperar el manipulador.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador de la ventana del control.

Si la función falla el valor de retorno en NULL, que indica que el manipulador de diálogo no es válido o que el control no existe.

Observaciones

Se puede usar GetDlgItem con cualquier pareja de ventanas padre-hija, no sólo con cuadros de diálogo. Siempre que el parámetro hDlg especifique una ventana padre y la ventana hija tenga un identificador único (tal como se especifica en el parámetro hMenu de la función CreateWindow o CreateWindowEx de la ventana hija creada), GetDlgItem devolverá un manipulador válido a la ventana hija.