winuser.h


GetWindowText

Copia el texto de la barra de título de la ventana especificada, (si es que la tiene) en un buffer. Si la ventana especificada es un control, se copia el texto del control.

Sintaxis

int GetWindowText(
    HWND hWnd,       // manipulador de ventana o control con texto
    LPTSTR lpString, // dirección de buffer para el texto
    int nMaxCount    // número máximo de caracteres a copiar
   );

Parámetros

hWnd: identifica la ventana o control que contiene el texto.

lpString: puntero al buffer que recibirá el texto.

nMaxCount: especifica el número máximo de caracteres a copiar al buffer. Si el texto excede ese límite, se trancará.

Valor de retorno

Si la función tiene éxito, el valor de retorno es la longitud, en caracteres, de la cadena copiada, sin incluir el carácter nulo de fin de cadena. Si la ventana no tiene barra de título o texto, si la barra de título está vacía o si el manipulador de ventana o control es inválido, el valor de retorno es cero. Para obtener más información sobre el error, llamar a GetLastError.

Esta función no puede recuperar el texto de un control edit de otra aplicación.

Observaciones

Esta función hace que se envíe un mensaje WM_GETTEXT a la ventana o control especificado.

Esta función no puede recuperar el texto de un control edit de otra aplicación.