Función GetDlgItem (winuser.h)

Recupera un identificador de un control en el cuadro de diálogo especificado.

Sintaxis

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

Parámetros

[in, optional] hDlg

Tipo: HWND

Identificador del cuadro de diálogo que contiene el control .

[in] nIDDlgItem

Tipo: int

Identificador del control que se va a recuperar.

Valor devuelto

Tipo: HWND

Si la función se ejecuta correctamente, el valor devuelto es el identificador de ventana del control especificado.

Si se produce un error en la función, el valor devuelto es NULL, lo que indica un identificador de cuadro de diálogo no válido o un control inexistente. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Puede usar la función GetDlgItem con cualquier par de ventanas primarias y secundarias, no solo con cuadros de diálogo. Siempre que el parámetro hDlg especifique una ventana primaria y la ventana secundaria tenga un identificador único (según lo especificado por el parámetro hMenu en la función CreateWindow o CreateWindowEx que creó la ventana secundaria), GetDlgItem devuelve un identificador válido a la ventana secundaria.

Ejemplos

Para obtener un ejemplo, vea Inicializar un cuadro de diálogo.

Requisitos

Consulte también

Conceptual

CreateWindow

CreateWindowEx

Cuadros de diálogo

GetDlgItemInt

GetDlgItemText

Referencia