GetWindowText

GetWindowText função copia o texto da barra de título da janela especificada (se houver) em um buffer. Se a janela especificada for um controle, o texto do controle é copiado. No entanto, GetWindowText não pode recuperar o texto de um controle em outro aplicativo.

int (GetWindowText HWND  hWnd, / / identificador para janela ou controle com textoLPTSTRlpString, / / endereço do buffer para o textointnMaxCount / / máximo número de caracteres para copiar);
 

Parâmetros

hWnd
Identificador para a janela ou controle que contém o texto.
lpString
Ponteiro para o buffer que receberá o texto.
nMaxCount
Especifica o número máximo de caracteres para copiar para a reserva, incluindo o NULL caractere. Se o texto exceder esse limite, será truncado.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o comprimento, em caracteres, da seqüência de caracteres copiada, não incluindo o encerrando null caractere. Se a janela não tem nenhuma barra de título ou texto, se a barra de título está vazia, ou se o identificador janela ou Controlarar é inválido, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Essa função não é possível recuperar o texto de um controle editar em outro aplicativo.

Observações

Se a janela destino pertence o atual processo, GetWindowText faz com que um WM_GETTEXT mensagem seja enviada para a janela especificada ou controle. Se a janela destino pertence outro processo e tiver uma legenda, GetWindowText recupera o texto de legenda da janela. Se a janela não tem uma legenda, o valor de retorno é uma Cadeia de caracteres nula.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.

Ver também

Visão geral sobre Windows, funções de janela, GetWindowTextLength, SetWindowText, WM_GETTEXT

Index