Função DrawStatusTextW (commctrl.h)

Artigo
11/18/2024

A função DrawStatusText desenha o texto especificado no estilo de uma janela de status com bordas.

Sintaxe

void DrawStatusTextW(
  HDC     hDC,
  LPCRECT lprc,
  LPCWSTR pszText,
  UINT    uFlags
);

Parâmetros

hDC

Tipo: HDC

Manipule para o contexto de exibição da janela.

lprc

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém a posição, nas coordenadas do cliente, do retângulo no qual o texto é desenhado. A função desenha as bordas dentro das bordas do retângulo especificado.

pszText

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o texto a ser exibido. Os caracteres de tabulação na cadeia de caracteres determinam se a cadeia de caracteres está alinhada à esquerda, alinhada à direita ou centralizada.

uFlags

Tipo: UINT

Sinalizadores de desenho de texto. Esse parâmetro pode ser uma combinação desses valores:

Valor	Significado
SBT_NOBORDERS	Impede que as bordas sejam desenhadas em torno do texto especificado.
SBT_POPOUT	Desenha bordas realçadas que fazem o texto se destacar.
SBT_RTLREADING	Indica que a cadeia de caracteres apontada por pszText será exibida na direção oposta ao texto na janela pai.

Valor de retorno

Nenhum

Observações

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). Normalmente, a cadeia de caracteres pszText será exibida na mesma direção que o texto em sua janela pai. Se SBT_RTLREADING estiver definida, a cadeia de caracteres pszText será lida na direção oposta do texto na janela pai.

Nota

O cabeçalho commctrl.h define DrawStatusText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h
biblioteca	Comctl32.lib
de DLL	Comctl32.dll

Compartilhar via