winuser.h


SetDlgItemInt

La función SetDlgItemInt cambia el texto de un control en un cuadro de diálogo a la representación en forma de cadena de un valor entero especificado.

Sintaxis

BOOL SetDlgItemInt(
    HWND hwndDlg,   // manipulador al cuadro de diálogo
    int idControl,  // identificador del control
    UINT uValue,    // valor a cambiar
    BOOL fSigned    // indicador de con o sin signo
   );

Parámetros:

hwndDlg: identifica al cuadro de diálogo que contienen el control.

idControl: especifica el identificador del control que recibe el mensaje.

uValue: especifica el valor entero usado para generar el texto.

fSigned: especifica si el parámetro uValue es con o sin signo. Si este parámetro es TRUE, uValue es un valor con signo. Si este parámetro es TRUE y uValue es menor que cero, se insertará un signo menos antes del primer dígito de la cadena. Si el parámetro es FALSE, uValue es un valor sin signo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener más información, hay que usar la función GetLastError.

Observaciones

Para cambiar el nuevo texto, la función SetDlgItemInt envía un mensaje WM_SETTEXT al control especificado.