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 |
|
Voir aussi
-
Référence
-
Conceptuel
-
Autres ressources