WM_GETTEXTLENGTH

Um aplicativo envia uma mensagem WM_GETTEXTLENGTH para determinar o comprimento, em caracteres, o texto associado com uma janela. O comprimento não inclui o caractere nulo final.

WM_GETTEXTLENGTH wParam = 0; / / não é usado; deve ser zero lParam = 0; / / não é usado; deve ser zero 

 

Parâmetros

Esta mensagem não tem parâmetros.

Retornar valores

O valor de retorno é o comprimento, em caracteres, do texto.

Ação padrão

O DefWindowProc função retorna 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.

Observações

Para um controle editar, o texto a ser copiado é o conteúdo do Controlarar de editar. Para uma caixa de combinação, o texto é o conteúdo da parte editar Controlarar (ou estático-texto) da caixa de combinação. Para um botão, o texto é o nome do botão. Para outras janelas, o texto é o título da janela. Para determinar o comprimento de um item em uma caixa lista, um aplicativo pode usar a mensagem LB_GETTEXTLEN.

Sob certas condições, o DefWindowProc função retorna 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.

Para obter o tamanho exato do texto, use os WM_GETTEXT, LB_GETTEXT ou 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.

Ver também

Visão geral do Windows, mensagens de janela, CB_GETLBTEXT, DefWindowProc, GetWindowText, GetWindowTextLength, LB_GETTEXT, LB_GETTEXTLEN, WM_GETTEXT

Index