Message SB_SETTEXT

Définit le texte dans la partie spécifiée d’une fenêtre d’état.

Paramètres

wParam

Le LOBYTE du mot de bas ordre spécifie l’index de base zéro de la partie à définir. Si le LOBYTE est défini sur SB_SIMPLEID, la fenêtre d’état est supposée être une barre d’état de mode simple; autrement dit, une barre d’état avec une seule partie.

Le HIBYTE du mot de bas ordre spécifie le type de l’opération de dessin. Ce paramètre peut prendre les valeurs suivantes.

Le mot d’ordre élevé de wParam est ignoré.

Valeur	Signification
0	Le texte est dessiné avec une bordure à afficher inférieure au plan de la fenêtre.
SBT_NOBORDERS	Le texte est dessiné sans bordures.
SBT_OWNERDRAW	Le texte est dessiné par la fenêtre parente. Remarque : Une barre d’état en mode simple ne prend pas en charge le dessin du propriétaire.
SBT_POPOUT	Le texte est dessiné avec une bordure à afficher supérieure au plan de la fenêtre.
SBT_RTLREADING	Le texte s’affiche dans la direction opposée au texte de la fenêtre parente.
SBT_NOTABPARSING	Les caractères de tabulation sont ignorés.

lParam

Pointeur vers une chaîne terminée par null qui spécifie le texte à définir. Si wParam est SBT_OWNERDRAW, ce paramètre représente 32 bits de données. La fenêtre parente doit interpréter les données et dessiner le texte lorsqu’elle reçoit le message WM_DRAWITEM.

Valeur retournée

Retourne TRUE en cas de réussite, ou sinon FALSE.

Notes

Le message invalide la partie de la fenêtre qui a été modifiée, ce qui lui permet d’afficher le nouveau texte lors de la prochaine réception du message WM_PAINT.

Les fenêtres normales affichent le texte de gauche à droite (LTR). Windows peut être en miroir pour afficher des langues telles que l’hébreu ou l’arabe qui lisent de droite à gauche (RTL). Si SBT_RTLREADING est définie, la chaîne lParam lit dans la direction opposée du texte de la fenêtre parente.

Spécifications

Condition requise	Value
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Commctrl.h
Noms Unicode et ANSI	SB_SETTEXTW (Unicode) et SB_SETTEXTA (American National Standards Institute)

Voir aussi

SB_GETTEXT