winuser.h

Mensaje WM_SETTEXT

Definición

WM_SETTEXT
wParam = 0;                     // no se usa; debe ser cero
lParam = (LPARAM)(LPCTSTR)lpsz; // dirección de la cadena del texto de la ventana

Una aplicación envía un mensaje WM_SETTEXT para cambiar el texto de una ventana.

Descripción

lpsz: valor de lParam. Puntero a una cadena terminada en cero que contiene el texto de la ventana.

Valor de retorno

El valor de retorno es TRUE si el texto se cambia. Es FALSE (para un control edit), LB_ERRSPACE (para un list box) o CB_ERRSPACE (para un combo box) si no hay suficiente espacio disponible para colocar el texto en el control. Es CB_ERR si el mensaje se envía a un combo box sin control edit.

Acción por defecto

La función DefWindowProc cambia el texto de la ventana y lo muestra.

Observaciones

Para un control edit, el texto es el contenido el control edit. Para un combo box, el texto es el contenido de la porción control edit del combo box. Para un button, el texto es el nombre del botón. Para otras ventanas, el texto es el título de la ventana.

Este mensaje no cambia la selección actual en un list box o en un combo box. Una aplicación debe usar el mensaje CB_SELECTSTRING para seleccionar el ítem en un list box que coincida con el texto en el control edit.