SetWindowText

O SetWindowText função altera o texto da barra de título da janela especificada (se houver). Se a janela especificada for um controle, o texto do Controlarar é alterado. No entanto, SetWindowText não pode alterar o texto de um controle em outro aplicativo.

(BOOL SetWindowText HWND  hWnd, / / identificador para a janela ou controleLPCTSTRlpString / / endereço da Cadeia de caracteres);
 

Parâmetros

hWnd
Identificador para a janela ou controle cujo texto está a ser alterado.
lpString
Ponteiro para uma Cadeia de caracteres terminada por caractere nulo a ser usada como o novo texto de título ou Controlarar.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é diferente de zero.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se a janela destino pertence o atual processo, SetWindowText faz com que um WM_SETTEXT mensagem seja enviada para a janela especificada ou controle. Se o controle for um controle de caixa de listagem criado com o estilo WS_CAPTION, no entanto, SetWindowText define o texto para o controle, não para as entradas de caixa de lista.

O SetWindowText função não expansão guia caracteres (codificar ASCII 0x09). Caracteres de tabulação são exibidos como caracteres de barra verticais (|).

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, GetWindowText, WM_SETTEXT

Index