Función GetDlgItemInt (winuser.h)

Artículo
03/13/2024

Convierte el texto de un control especificado en un cuadro de diálogo en un valor entero.

Sintaxis

UINT GetDlgItemInt(
  [in]            HWND hDlg,
  [in]            int  nIDDlgItem,
  [out, optional] BOOL *lpTranslated,
  [in]            BOOL bSigned
);

Parámetros

[in] hDlg

Tipo: HWND

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

[in] nIDDlgItem

Tipo: int

Identificador del control cuyo texto se va a traducir.

[out, optional] lpTranslated

Tipo: BOOL*

Indica éxito o error (TRUE indica que se ha realizado correctamente, FALSE indica error).

Si este parámetro es NULL, la función no devuelve información sobre éxito o error.

[in] bSigned

Tipo: BOOL

Indica si la función debe examinar el texto de un signo menos al principio y devolver un valor entero con signo con signo si encuentra uno (TRUE especifica que se debe hacer, FALSE que no debería).

Valor devuelto

Tipo: UINT

Si la función se ejecuta correctamente, la variable a la que apunta lpTranslated se establece en TRUE y el valor devuelto es el valor traducido del texto del control.

Si se produce un error en la función, la variable a la que apunta lpTranslated se establece en FALSE y el valor devuelto es cero. Tenga en cuenta que, dado que cero es un valor traducido posible, un valor devuelto de cero no indica por sí solo un error.

Si lpTranslated es NULL, la función no devuelve información sobre éxito o error.

Tenga en cuenta que, si el parámetro bSigned es TRUE y hay un signo menos (–) al principio del texto, GetDlgItemInt convierte el texto en un valor entero con signo. De lo contrario, la función crea un valor entero sin signo. Para obtener el valor adecuado en este caso, convierta el valor devuelto en un tipo int .

Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetDlgItemInt recupera el texto del control especificado enviando al control un mensaje de WM_GETTEXT . La función traduce el texto recuperado quitando los espacios adicionales al principio del texto y, a continuación, convirtiendo los dígitos decimales. La función detiene la traducción cuando llega al final del texto o cuando encuentra cualquier carácter no numérico.

La función GetDlgItemInt devuelve cero si el valor traducido es mayor que INT_MAX (para números con signo) o UINT_MAX (para números sin signo).

Ejemplos

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

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-2 (introducido en Windows 10, versión 10.0.10240)