mensaje de WM_GETTEXT

Copia el texto que corresponde a una ventana en un búfer proporcionado por el autor de la llamada.

#define WM_GETTEXT                      0x000D

Parámetros

wParam

Número máximo de caracteres que se van a copiar, incluido el carácter nulo de terminación.

Las aplicaciones ANSI pueden tener la cadena en el búfer reducido en tamaño (hasta un mínimo de la mitad del valor wParam ) debido a la conversión de ANSI a Unicode.

lParam

Puntero al búfer que va a recibir el texto.

Valor devuelto

Tipo: LRESULT

El valor devuelto es el número de caracteres copiados, no incluido el carácter nulo de terminación.

Observaciones

La función DefWindowProc copia el texto asociado a la ventana en el búfer especificado y devuelve el número de caracteres copiados. Tenga en cuenta que, para los controles estáticos que no son de texto, se proporciona el texto con el que se creó originalmente el control, es decir, el número de identificador. Sin embargo, proporciona el identificador del control estático que no es de texto como se creó originalmente. Es decir, si posteriormente usó un STM_SETIMAGE para cambiarlo, se seguirá devolviendo el identificador original.

Para un control de edición, el texto que se va a copiar es el contenido del control de edición. Para un cuadro combinado, el texto es el contenido de la parte del control de edición (o texto estático) del cuadro combinado. Para un botón, el texto es el nombre del botón. Para otras ventanas, el texto es el título de la ventana. Para copiar el texto de un elemento en un cuadro de lista, una aplicación puede usar el mensaje de LB_GETTEXT .

Cuando el mensaje de WM_GETTEXT se envía a un control estático con el estilo SS_ICON , se devolverá un identificador al icono en los cuatro primeros bytes del búfer al que apunta lParam. Esto solo es true si se ha usado el mensaje WM_SETTEXT para establecer el icono.

Edición enriquecida: Si el texto que se va a copiar supera los 64K, use el mensaje EM_STREAMOUT o EM_GETSELTEXT .

El envío de un mensaje WM_GETTEXT a un control estático que no sea de texto, como un mapa de bits estático o un control de icono estático, no devuelve un valor de cadena. En su lugar, devuelve cero. Además, en versiones anteriores de Windows, las aplicaciones podían enviar un mensaje WM_GETTEXT a un control estático que no es de texto para recuperar el identificador del control. Para recuperar el identificador de un control, las aplicaciones pueden usar GetWindowLong pasando GWL_ID como valor de índice o GetWindowLongPtr mediante GWLP_ID.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Winuser.h (incluye Windows.h)

Consulte también

Referencia

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

Conceptual

Windows

Otros recursos

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT