Función GetDlgItem (winuser.h)

Artículo
03/13/2024

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

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-dialogbox-l1-1-0 (introducido en Windows 8)