GetWindowTextLength

A GetWindowTextLength função recupera o comprimento, em caracteres, do texto da barra de título da janela especificada (se a janela tem uma barra de título). Se a janela especificada for um controle, a função recupera o comprimento do texto dentro do Controlarar. No entanto, GetWindowTextLength não é possível recuperar o ComComprimento do texto de um controle editar em outro aplicativo.

int (GetWindowTextLength HWND  hWnd / / identificador para janela ou controle com texto);
 

Parâmetros

hWnd
Identificador para a janela ou controle.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é o comprimento, em caracteres, do texto. Sob certas condições, esse valor pode realmente ser maior que o comprimento do texto. Para obter mais informações, consulte a seguinte seção Comentários.

Se a janela não tiver texto, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se a janela destino pertence o atual processo, GetWindowTextLength faz com que um WM_GETTEXTLENGTH mensagem seja enviada para a janela especificada ou controle.

Sob certas condições, a GetWindowTextLength função pode retornar um valor que seja maior que o comprimento real do texto. Isso ocorre com determinados mixtures de ANSI e Unicode e é devido ao sistema permitindo a possível existência de DBCS caracteres dentro do texto. O valor de retorno, no entanto, será sempre pelo menos tão grande quanto o real tamanho do texto; Você pode, portanto, sempre usá-lo para orientar a alocação do buffer. Este comportamento pode ocorrer quando um aplicativo usa funções ANSI e em diálogos comuns, que usam Unicode. Ele também pode ocorrer quando um aplicativo usa a versão ANSI GetWindowTextLength com uma janela cujo procedimento janela é Unicode, ou a versão Unicode de GetWindowTextLength com uma janela cujo procedimento janela é ANSI. Para obter mais informações sobre as funções ANSI e Unicode, consulte Protótipos de função de Win32.

Para obter o tamanho exato do texto, use os WM_GETTEXT, LB_GETTEXTou CB_GETLBTEXT mensagens, ou a GetWindowText função.

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, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, SetWindowText, WM_GETTEXT, WM_GETTEXTLENGTH

Index