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 |
|---|---|
|
Le texte est dessiné avec une bordure pour apparaître plus bas que le plan de la fenêtre. |
|
Le texte est dessiné sans bordures. |
|
Le texte est dessiné avec une bordure pour apparaître plus haut que le plan de la fenêtre. |
|
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 |
|
| Noms Unicode et ANSI |
SB_GETTEXTW (Unicode) et SB_GETTEXTA (ANSI) |