Mensaje SB_SETTEXT

Establece el texto de la parte especificada de una ventana de estado.

Parámetros

wParam

El LOBYTE de la palabra de orden bajo especifica el índice de base cero del elemento que se va a establecer. Si LOBYTE se establece en SB_SIMPLEID, se supone que la ventana de estado es una barra de estado de modo simple; es decir, una barra de estado con una sola parte.

El HIBYTE de la palabra de orden bajo especifica el tipo de la operación de dibujo. Este parámetro puede ser uno de los valores siguientes.

Se omite la palabra de orden superior de wParam.

Value Significado
0
El texto se dibuja con un borde para que aparezca inferior al plano de la ventana.
SBT_NOBORDERS
El texto se dibuja sin bordes.
SBT_OWNERDRAW
El texto se dibuja mediante la ventana primaria.
Nota: Una barra de estado de modo simple no admite el dibujo del propietario.
SBT_POPOUT
El texto se dibuja con un borde para que aparezca más alto que el plano de la ventana.
SBT_RTLREADING
El texto se mostrará en la dirección opuesta al texto de la ventana primaria.
SBT_NOTABPARSING
Se omiten los caracteres de tabulación.

lParam

Puntero a una cadena terminada en null que especifica el texto que se va a establecer. Si wParam es SBT_OWNERDRAW, este parámetro representa 32 bits de datos. La ventana primaria debe interpretar los datos y dibujar el texto cuando recibe el mensaje WM_DRAWITEM.

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE en caso contrario.

Comentarios

El mensaje invalida la parte de la ventana que ha cambiado y se muestra el texto nuevo cuando la ventana siguiente recibe el mensaje WM_PAINT.

Las ventanas normales muestran texto de izquierda a derecha (LTR). Windows se puede reflejar para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Si se establece SBT_RTLREADING, la cadena lParam leerá en la dirección opuesta del texto de la ventana primaria.

Requisitos

Requisito Valor
Cliente mínimo compatible
Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado
Commctrl.h
Nombres Unicode y ANSI
SB_SETTEXTW (Unicode) y SB_SETTEXTA (ANSI)

Consulte también

SB_GETTEXT