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	Winuser.h (inclure Windows.h)

Voir aussi

Référence

EM_SETHANDLE

Autres ressources

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock