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 |
|
Confira também
-
Referência
-
Conceitual
-
Outros recursos