Función GetDlgCtrlID (winuser.h)

Recupera el identificador del control especificado.

Sintaxis

int GetDlgCtrlID(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador del control.

Valor devuelto

Tipo: int

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

Si la función no se realiza correctamente, el valor devuelto es cero. Un valor no válido para el parámetro hwndCtl , por ejemplo, provocará un error en la función. Para obtener información de error extendida, llame a GetLastError.

Comentarios

GetDlgCtrlID acepta identificadores de ventana secundarios, así como identificadores de controles en cuadros de diálogo. Una aplicación establece el identificador de una ventana secundaria cuando crea la ventana asignando el valor de identificador al parámetro hmenu al llamar a la función CreateWindow o CreateWindowEx .

Aunque GetDlgCtrlID puede devolver un valor si hwndCtl es un identificador de una ventana de nivel superior, las ventanas de nivel superior no pueden tener identificadores y este valor devuelto nunca es válido.

Ejemplos

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

Requisitos

   
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)

Consulte también

Conceptual

CreateWindow

CreateWindowEx

Cuadros de diálogo

GetDlgItem

Referencia