Mensaje _ GETTEXTLENGTH de WM

Determina la longitud, en caracteres, del texto asociado a una ventana.

#define WM_GETTEXTLENGTH                0x000E

Parámetros

wParam

Este parámetro no se usa y debe ser cero.

lParam

Este parámetro no se usa y debe ser cero.

Valor devuelto

Tipo: LRESULT

El valor devuelto es la longitud del texto en caracteres, sin incluir el carácter nulo final.

Comentarios

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 determinar la longitud de un elemento en un cuadro de lista, una aplicación puede usar el mensaje _ LB GETTEXTLEN.

Cuando se envía el mensaje WM _ GETTEXTLENGTH, la función DefWindowProc devuelve la longitud, en caracteres, del texto. En determinadas condiciones, la función DefWindowProc devuelve un valor mayor que la longitud real del texto. Esto se produce con ciertas mezclas de ANSI y Unicode, y se debe a que el sistema permite la posible existencia de caracteres de juego de caracteres de doble byte (DBCS) dentro del texto. Sin embargo, el valor devuelto siempre será al menos tan grande como la longitud real del texto; Por lo tanto, siempre puede usarlo para guiar la asignación del búfer. Este comportamiento puede producirse cuando una aplicación usa funciones ANSI y diálogos comunes, que usan Unicode.

Para obtener la longitud exacta del texto, use los mensajes WM _ GETTEXT, LB _ GETTEXTo CB _ GETLBTEXT, o la función GetWindowText.

El envío de _ un mensaje GETTEXTLENGTH de WM 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.

Requisitos

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

Vea también

Referencia

DefWindowProc

GetWindowText

GetWindowTextLength

WM _ GETTEXT

Conceptual

Windows

Otros recursos

CB _ GETLBTEXT

LB _ GETTEXT

LB _ GETTEXTLEN