Partilhar via


WM_SETTEXT mensagem

Define o texto de uma janela.

#define WM_SETTEXT                      0x000C

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Um ponteiro para uma cadeia de caracteres terminada em nulo que é o texto da janela.

Valor retornado

Tipo: LRESULT

O valor retornado será TRUE se o texto estiver definido. Ele será FALSE (para um controle de edição), LB_ERRSPACE (para uma caixa de listagem) ou CB_ERRSPACE (para uma caixa de combinação) se espaço insuficiente estiver disponível para definir o texto no controle de edição. Ele será CB_ERR se essa mensagem for enviada para uma caixa de combinação sem um controle de edição.

Comentários

A função DefWindowProc define e exibe o texto da janela. Para um controle de edição, o texto é o conteúdo do controle de edição. Para uma caixa de combinação, o texto é o conteúdo da parte edit-control 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.

Essa mensagem não altera a seleção atual na caixa de listagem de uma caixa de combinação. Um aplicativo deve usar a mensagem CB_SELECTSTRING para selecionar o item em uma caixa de listagem que corresponda ao texto no controle de edição.

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

WM_GETTEXT

Conceitual

Windows

Outros recursos

CB_SELECTSTRING