winuser.h


SetWindowText

La función SetWindowText cambia el texto de la barra de título de la ventana especificada (si es que tiene). Si la ventana especificada es un control, se modificará su texto.

Sintaxis

BOOL SetWindowText(
    HWND hwnd,    // manipulador de ventana o control
    LPCTSTR lpsz  // dirección de cadena
   );

Parámetros:

hwnd: identifica la ventana o control cuyo texto se modificará.

lpsz: puntero a cadena terminada con nulo que se usará como nuevo título o texto de control.

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 mayor información sobre el error, llamar a GetLastError.

Observaciones

La función SetWindowText hace que se envíe un mensaje WM_SETTEXT a la ventana o control especificado. Sin embargo, si la ventana es un control listbox creado con el estilo WS_CAPTION, SetWindowText cambia el texto del control, y no las entradas del listbox.

La función SetWindowText no expande los caracteres de tabulación (código ASCII 0x09). Esos caracteres se muestran como caracteres de barra vertical (|).