EM_GETHANDLE message
Obtient un handle de la mémoire actuellement allouée pour le texte d’un contrôle d’édition multiligne.
Paramètres
-
wParam
-
Non utilisé ; doit être égal à zéro.
-
lParam
-
Non utilisé ; doit être égal à zéro.
Valeur retournée
La valeur de retour est un handle de mémoire identifiant la mémoire tampon qui contient le contenu du contrôle d’édition. Si une erreur se produit, comme l’envoi du message à un contrôle d’édition à une ligne, la valeur de retour est zéro.
Notes
Si la fonction réussit, l’application peut accéder au contenu du contrôle d’édition en cassant la valeur de retour en HLOCAL et en la transmettant à LocalLock. LocalLock retourne un pointeur vers une mémoire tampon qui est un tableau avec fin null de CHARou WCHAR, selon qu’une fonction ANSI ou Unicode a créé le contrôle. Par exemple, si CreateWindowExA a été utilisé, la mémoire tampon est un tableau de s CHAR, mais si CreateWindowExW a été utilisé, la mémoire tampon est un tableau de WCHAR. L’application ne peut pas modifier le contenu de la mémoire tampon. Pour déverrouiller la mémoire tampon, l’application appelle LocalUnlock avant d’autoriser le contrôle d’édition à recevoir de nouveaux messages.
Notes
Pour Comctl32.dll version 6, la mémoire tampon contient toujours un tableau de WCHAR, qu’une fonction ANSI ou Unicode ait créé le contrôle d’édition. Pour plus d’informations sur les versions dll, consultez Versions de contrôle commun.
Si votre application ne peut pas respecter les restrictions imposées par EM_GETHANDLE, utilisez les fonctions GetWindowTextLength et GetWindowText pour copier le contenu du contrôle d’édition dans une mémoire tampon fournie par l’application.
Modification enrichie : Le message EM_GETHANDLE n’est pas pris en charge. Les contrôles d’édition enrichi ne stockent pas de texte sous la forme d’un simple tableau de caractères.
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 |
|
Voir aussi
-
Référence
-
Autres ressources