Función GetDlgItemInt (winuser.h)
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) |
Consulte también
Conceptual
Referencia