Share via


Função DrawCaption (winuser.h)

A função DrawCaption desenha uma janela legenda.

Sintaxe

BOOL DrawCaption(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Parâmetros

[in] hwnd

Um identificador para uma janela que fornece texto e um ícone para a janela legenda.

[in] hdc

Um identificador para um contexto de dispositivo. A função desenha a legenda da janela nesse contexto do dispositivo.

[in] lprect

Um ponteiro para uma estrutura RECT que especifica o retângulo delimitador para a janela legenda em coordenadas lógicas.

[in] flags

As opções de desenho. Esse parâmetro pode ser zero ou mais dos valores a seguir.

Valor Significado
DC_ACTIVE
A função usa as cores que denotam um legenda ativo.
DC_BUTTONS
Se definida, a função desenha os botões na barra de legenda (para minimizar, restaurar ou fechar um aplicativo).
DC_GRADIENT
Quando esse sinalizador é definido, a função usa COLOR_GRADIENTACTIVECAPTION (se o sinalizador DC_ACTIVE foi definido) ou COLOR_GRADIENTINACTIVECAPTION para a cor da barra de título.

Se esse sinalizador não estiver definido, a função usará COLOR_ACTIVECAPTION ou COLOR_INACTIVECAPTION para ambas as cores.

DC_ICON
A função desenha o ícone ao desenhar o texto legenda.
DC_INBUTTON
A função desenha o legenda como um botão.
DC_SMALLCAP
A função desenha uma pequena legenda, usando a fonte de legenda pequena atual.
DC_TEXT
A função desenha o texto legenda ao desenhar o legenda.
 

Se DC_SMALLCAP for especificado, a função desenhará uma janela normal legenda.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT