Función SetWindowTextA (winuser.h)

Artículo
08/28/2023

Cambia el texto de la barra de título de la ventana especificada (si tiene una). Si la ventana especificada es un control, se cambia el texto del control. Sin embargo, SetWindowText no puede cambiar el texto de un control en otra aplicación.

Sintaxis

BOOL SetWindowTextA(
  [in]           HWND   hWnd,
  [in, optional] LPCSTR lpString
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana o control cuyo texto se va a cambiar.

[in, optional] lpString

Tipo: LPCTSTR

Nuevo texto de título o control.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si la ventana de destino es propiedad del proceso actual, SetWindowText hace que se envíe un mensaje de WM_SETTEXT a la ventana o control especificados. Sin embargo, si el control es un control de cuadro de lista creado con el estilo WS_CAPTION , SetWindowText establece el texto del control, no para las entradas del cuadro de lista.

Para establecer el texto de un control en otro proceso, envíe el mensaje WM_SETTEXT directamente en lugar de llamar a SetWindowText.

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

Ejemplos

Para obtener un ejemplo, consulte Envío de un mensaje.

Nota

El encabezado winuser.h define SetWindowText como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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-window-l1-1-3 (introducido en Windows 10, versión 10.0.10240)