Partilhar via

SB_GETTEXTLENGTH mensagem

  • Artigo

Recupera o comprimento, em caracteres, do texto da parte especificada de uma janela status.

Parâmetros

wParam

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

lParam

Deve ser zero.

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 seguintes valores:

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_OWNERDRAW
 O texto é desenhado pela janela pai.
SBT_POPOUT
 O texto é desenhado com uma borda para aparecer acima do plano da janela.
SBT_RTLREADING
 O texto será exibido na direção oposta ao texto na janela pai.

Comentários

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, o texto da janela status especificado será lido na direção oposta do texto na janela pai.

Esta mensagem retorna um comprimento máximo de cadeia de caracteres de 65.535 caracteres. Se a cadeia de caracteres de texto real for maior que isso, a mensagem SB_GETTEXT a truncará.

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_GETTEXTLENGTHW (Unicode) e ANSI (SB_GETTEXTLENGTHA )