SB_GETTEXT message

Récupère le texte de la partie spécifiée d’une fenêtre status.

Paramètres

wParam

Index de base zéro de la partie à partir de laquelle récupérer du texte.

lParam

Pointeur vers la mémoire tampon qui reçoit le texte sous la forme d’une chaîne terminée par null. Utilisez le message SB_GETTEXTLENGTH pour déterminer la taille requise de la mémoire tampon.

Valeur retournée

Retourne une valeur 32 bits qui se compose de deux valeurs 16 bits. Le mot bas spécifie la longueur, en caractères, du texte. Le mot élevé spécifie le type d’opération utilisé pour dessiner le texte. Le type peut être l’une des valeurs suivantes.

Code de retour	Description
0	Le texte est dessiné avec une bordure pour apparaître plus bas que le plan de la fenêtre.
SBT_NOBORDERS	Le texte est dessiné sans bordures.
SBT_POPOUT	Le texte est dessiné avec une bordure pour apparaître plus haut que le plan de la fenêtre.
SBT_RTLREADING	Le texte s’affiche dans le sens inverse du texte dans la fenêtre parente.

Notes

Avertissement de sécurité : L’utilisation incorrecte de ce message peut compromettre la sécurité de votre programme. Ce message ne vous permet pas de connaître la taille de la mémoire tampon. Si vous utilisez ce message, appelez d’abord SB_GETTEXTLENGTH pour obtenir le nombre de caractères requis, puis appelez le message pour récupérer la chaîne. Si vous attendez avant d’appeler SB_GETTEXT le texte peut changer, invalidant ainsi la valeur de retour de SB_GETTEXTLENGTH. Vous devez passer en revue les considérations relatives à la sécurité : Contrôles Microsoft Windows avant de continuer.

Ce message retourne un maximum de 65 535 caractères. Si la chaîne de texte est plus longue, elle est tronquée.

Si le texte a le type de dessin SBT_OWNERDRAW, ce message retourne la valeur 32 bits associée au texte au lieu de la longueur et du type d’opération.

Les fenêtres normales affichent le texte de gauche à droite (LTR). Windows peut être mis 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éfini, la chaîne lParam lit dans le sens opposé du texte dans la fenêtre parente.

Spécifications

Condition requise	Valeur
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_GETTEXTW (Unicode) et SB_GETTEXTA (ANSI)

Voir aussi

SB_SETTEXT