mensaje de EM_GETHANDLE
Obtiene un identificador de la memoria asignada actualmente para el texto de un control de edición multilínea.
Parámetros
-
wParam
-
No se utiliza; debe ser cero.
-
lParam
-
No se utiliza; debe ser cero.
Valor devuelto
El valor devuelto es un identificador de memoria que identifica el búfer que contiene el contenido del control de edición. Si se produce un error, como enviar el mensaje a un control de edición de una sola línea, el valor devuelto es cero.
Comentarios
Si la función se ejecuta correctamente, la aplicación puede acceder al contenido del control de edición mediante la conversión del valor devuelto a HLOCAL y pasarlo a LocalLock. LocalLock devuelve un puntero a un búfer que es una matriz terminada en null de CHARs o WCHARs, dependiendo de si una función ANSI o Unicode creó el control. Por ejemplo, si se usó CreateWindowExA , el búfer es una matriz de CHARs, pero si se usó CreateWindowExW , el búfer es una matriz de WCHARs. Es posible que la aplicación no cambie el contenido del búfer. Para desbloquear el búfer, la aplicación llama a LocalUnlock antes de permitir que el control de edición reciba nuevos mensajes.
Nota
Para Comctl32.dll versión 6, el búfer siempre contiene una matriz de WCHARs, independientemente de si una función ANSI o Unicode creó el control de edición. Para obtener más información sobre las versiones dll, consulte Versiones de control comunes.
Si la aplicación no puede cumplir las restricciones impuestas por EM_GETHANDLE, use las funciones GetWindowTextLength y GetWindowText para copiar el contenido del control de edición en un búfer proporcionado por la aplicación.
Edición enriquecida: No se admite el mensaje EM_GETHANDLE . Los controles de edición enriquecidos no almacenan texto como una simple matriz de caracteres.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado |
|
Consulte también
-
Referencia
-
Otros recursos