_Message SB GETTEXT

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

Paramètres

wParam

Index de base zéro du composant à partir duquel 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 le caractère null. Utilisez le message SB _ GETTEXTLENGTH pour déterminer la taille requise pour la mémoire tampon.

Valeur de retour

Retourne une valeur 32 bits qui se compose de valeurs 2 16 bits. Le mot de poids faible spécifie la longueur, en caractères, du texte. Le mot de poids fort spécifie le type d’opération utilisé pour dessiner le texte. Le type peut prendre l’une des valeurs suivantes.

Code de retour Description
0
Le texte est dessiné avec une bordure qui apparaît plus bas que le plan de la fenêtre.
SBT _ NOfrontières
Le texte est dessiné sans bordures.
SBT _ fenêtre indépendante
Le texte est dessiné avec une bordure qui doit apparaître plus haut que le plan de la fenêtre.
SBT _ RTLREADING
Le texte s’affiche dans la direction opposée 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 n’offre aucun moyen 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, le texte pourrait changer, invalidant ainsi la valeur de retour de SB _ GETTEXTLENGTH. _ vous devez examiner 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). les Windows peuvent être mis en miroir pour afficher des langues telles que l’hébreu ou l’arabe, qui sont lues 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 [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
Commctrl. h
Noms Unicode et ANSI
SB _ GETTEXTW (Unicode) et SB _ gettexta (ANSI)

Voir aussi

unisettext SB _