Mensagem SB_SETTEXT

Define o texto na parte especificada de uma janela de status.

Parâmetros

wParam

O LOBYTE da palavra de ordem baixa especifica o índice baseado em zero da parte a ser definida. Se o LOBYTE estiver definido como SB_SIMPLEID, a janela de status é assumida como uma barra de status de modo simples, ou seja, uma barra de status com apenas uma parte.

O HIBYTE da palavra de ordem baixa especifica o tipo da operação de desenho. Esse parâmetro pode usar um dos valores a seguir.

A palavra de ordem alta de wParam é ignorada.

Valor	Significado
0	O texto é desenhado com uma borda a ser exibida abaixo do plano da janela.
SBT_NOBORDERS	O texto é desenhado sem bordas.
SBT_OWNERDRAW	O texto é desenhado pela janela pai. Observação: uma barra de status de modo simples não oferece suporte ao desenho do proprietário.
SBT_POPOUT	O texto é desenhado com uma borda a ser exibida acima do plano da janela.
SBT_RTLREADING	O texto será exibido na direção oposta ao texto na janela pai.
SBT_NOTABPARSING	Os caracteres de tabulação são ignorados.

lParam

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o texto a ser definido. Se wParam for SBT_OWNERDRAW, esse parâmetro representará 32 bits de dados. A janela pai deve interpretar os dados e desenhar o texto quando receber a mensagem WM_DRAWITEM.

Valor retornado

Retorna TRUE se for bem-sucedido ou FALSE se não for.

Comentários

A mensagem invalida a parte da janela que foi alterada, fazendo com que ela exiba o novo texto quando a janela seguinte receber a mensagem WM_PAINT.

As janelas normais exibem texto da esquerda para a direita (LTR). As janelas podem ser espelhadas para exibir idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL). Se SBT_RTLREADING estiver definido, a cadeia de caracteres lParam será lida na direção oposta ao texto na janela pai.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	Commctrl.h
Nomes Unicode e ANSI	SB_SETTEXTW (Unicode) e SB_SETTEXTA (ANSI)

Confira também

SB_GETTEXT