Partilhar via

SB_GETTEXT mensagem

  • Artigo

Recupera o texto da parte especificada de uma janela status.

Parâmetros

wParam

Índice baseado em zero da parte da qual recuperar texto.

lParam

Ponteiro para o buffer que recebe o texto como uma cadeia de caracteres terminada em nulo. Use a mensagem SB_GETTEXTLENGTH para determinar o tamanho necessário do buffer.

Valor retornado

Retorna um valor de 32 bits que consiste em dois valores de 16 bits. A palavra baixa especifica o comprimento, em caracteres, do texto. A palavra alta especifica o tipo de operação usado para desenhar o texto. O tipo pode ser um dos valores a seguir.

Código de retorno Descrição
0
 O texto é desenhado com uma borda para aparecer abaixo do plano da janela.
SBT_NOBORDERS
 O texto é desenhado sem bordas.
SBT_POPOUT
 O texto é desenhado com uma borda para aparecer acima do plano da janela.
SBT_RTLREADING
 O texto é exibido na direção oposta do texto na janela pai.

Comentários

Aviso de segurança: Usar essa mensagem incorretamente pode comprometer a segurança do programa. Essa mensagem não fornece uma maneira de saber o tamanho do buffer. Se você usar essa mensagem, primeiro chame SB_GETTEXTLENGTH para obter o número de caracteres necessários e, em seguida, chame a mensagem para recuperar a cadeia de caracteres. Se você aguardar antes de chamar SB_GETTEXT o texto pode ser alterado, invalidando assim o valor retornado de SB_GETTEXTLENGTH. Você deve examinar as Considerações de Segurança: Controles do Microsoft Windows antes de continuar.

Esta mensagem retorna um máximo de 65.535 caracteres. Se a cadeia de caracteres de texto for maior que isso, ela será truncada.

Se o texto tiver o tipo de desenho SBT_OWNERDRAW, essa mensagem retornará o valor de 32 bits associado ao texto em vez do tamanho e do tipo de operação.

Janelas normais exibem texto da esquerda para a direita (LTR). O Windows pode ser espelhado 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 lerá na direção oposta do 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_GETTEXTW (Unicode) e ANSI (SB_GETTEXTA )

Confira também

SB_SETTEXT