Compartilhar via


WM_GETTEXTLENGTH mensagem

Determina o comprimento, em caracteres, do texto associado a uma janela.

#define WM_GETTEXTLENGTH                0x000E

Parâmetros

wParam

Esse parâmetro não é usado e deve ser zero.

lParam

Esse parâmetro não é usado e deve ser zero.

Valor retornado

Tipo: LRESULT

O valor retornado é o comprimento do texto em caracteres, não incluindo o caractere nulo de terminação.

Comentários

Para um controle de edição, o texto a ser copiado é o conteúdo do controle de edição. Para uma caixa de combinação, o texto é o conteúdo da parte de controle de edição (ou texto estático) 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 de listagem, um aplicativo pode usar a mensagem LB_GETTEXTLEN .

Quando a mensagem WM_GETTEXTLENGTH é enviada, a função DefWindowProc retorna o comprimento, em caracteres, do texto. Em determinadas condições, a função DefWindowProc retorna um valor maior que o comprimento real do texto. Isso ocorre com determinadas misturas de ANSI e Unicode e se deve ao sistema que permite a possível existência de caracteres DBCS (conjunto de caracteres de byte duplo) dentro do texto. O valor retornado, no entanto, sempre será pelo menos tão grande quanto o comprimento real do texto; portanto, você sempre pode usá-lo para orientar a alocação de buffer. Esse comportamento pode ocorrer quando um aplicativo usa funções ANSI e caixas de diálogo comuns, que usam Unicode.

Para obter o comprimento exato do texto, use as mensagens WM_GETTEXT, LB_GETTEXT ou CB_GETLBTEXT ou a função GetWindowText .

Enviar uma mensagem de WM_GETTEXTLENGTH para um controle estático que não seja de texto, como um bitmap estático ou um controle de ícone estático, não retorna um valor de cadeia de caracteres. Em vez disso, ele retorna zero.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

DefWindowProc

Getwindowtext

GetWindowTextLength

WM_GETTEXT

Conceitual

Windows

Outros recursos

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN