Função DrawStatusTextW (commctrl.h)

  • Artigo

A função DrawStatusText desenha o texto especificado no estilo de uma janela 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 bordas sejam desenhadas em torno do texto especificado.
SBT_POPOUT
 Desenha bordas realçadas que fazem com que o texto se destaque.
SBT_RTLREADING
 Indica que a cadeia de caracteres apontada por pszText será exibida na direção oposta ao texto na janela pai.

Retornar valor

Nenhum

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). 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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Plataforma de Destino Windows
Cabeçalho commctrl.h
Biblioteca Comctl32.lib
DLL Comctl32.dll