WM_GETTEXT message

Copie le texte qui correspond à une fenêtre dans une mémoire tampon fournie par l’appelant.

#define WM_GETTEXT                      0x000D

Paramètres

wParam

Nombre maximal de caractères à copier, y compris le caractère null de fin.

Les applications ANSI peuvent avoir la chaîne dans la mémoire tampon réduite en taille (à un minimum de la moitié de la valeur wParam ) en raison de la conversion d’ANSI en Unicode.

lParam

Pointeur vers la mémoire tampon qui doit recevoir le texte.

Valeur retournée

Type : LRESULT

La valeur de retour correspond au nombre de caractères copiés, sans compter le caractère null de fin.

Notes

La fonction DefWindowProc copie le texte associé à la fenêtre dans la mémoire tampon spécifiée et retourne le nombre de caractères copiés. Notez que pour les contrôles statiques non textuels, cela vous donne le texte avec lequel le contrôle a été créé à l’origine, c’est-à-dire le numéro d’ID. Toutefois, il vous donne l’ID du contrôle statique non textuel tel qu’il a été créé à l’origine. Autrement dit, si vous avez ensuite utilisé un STM_SETIMAGE pour le modifier, l’ID d’origine est toujours retourné.

Pour un contrôle d’édition, le texte à copier est le contenu du contrôle d’édition. Pour une zone de liste déroulante, le texte est le contenu de la partie de contrôle d’édition (ou texte statique) de la zone de liste déroulante. Pour un bouton, le texte est le nom du bouton. Pour les autres fenêtres, le texte est le titre de la fenêtre. Pour copier le texte d’un élément dans une zone de liste, une application peut utiliser le message LB_GETTEXT .

Lorsque le message WM_GETTEXT est envoyé à un contrôle statique avec le style SS_ICON , un handle à l’icône est retourné dans les quatre premiers octets de la mémoire tampon pointée vers lParam. Cela est vrai uniquement si le message WM_SETTEXT a été utilisé pour définir l’icône.

Modification enrichie : Si le texte à copier dépasse 64 Ko, utilisez le message EM_STREAMOUT ou EM_GETSELTEXT .

L’envoi d’un message WM_GETTEXT à un contrôle statique non textuel, tel qu’un contrôle bitmap statique ou un contrôle d’icône statique, ne retourne pas de valeur de chaîne. Au lieu de cela, il retourne zéro. En outre, dans les premières versions de Windows, les applications pouvaient envoyer un message WM_GETTEXT à un contrôle statique non textuel pour récupérer l’ID du contrôle. Pour récupérer l’ID d’un contrôle, les applications peuvent utiliser GetWindowLong passant GWL_ID comme valeur d’index ou GetWindowLongPtr àl’aide de GWLP_ID.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winuser.h (inclure Windows.h)

Voir aussi

Référence

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

Conceptuel

Windows

Autres ressources

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT