Função FillRect (winuser.h)

Artigo
08/27/2023

A função FillRect preenche um retângulo usando o pincel especificado. Essa função inclui as bordas esquerda e superior, mas exclui as bordas direita e inferior do retângulo.

Sintaxe

int FillRect(
  [in] HDC        hDC,
  [in] const RECT *lprc,
  [in] HBRUSH     hbr
);

Parâmetros

[in] hDC

Um identificador para o contexto do dispositivo.

[in] lprc

Um ponteiro para uma estrutura RECT que contém as coordenadas lógicas do retângulo a ser preenchido.

[in] hbr

Um identificador para o pincel usado para preencher o retângulo.

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.

Comentários

O pincel identificado pelo parâmetro hbr pode ser um identificador para um pincel lógico ou um valor de cor. Se estiver especificando um identificador para um pincel lógico, chame uma das seguintes funções para obter o identificador: CreateHatchBrush, CreatePatternBrush ou CreateSolidBrush. Além disso, você pode recuperar um identificador para um dos pincéis de estoque usando a função GetStockObject . Se estiver especificando um valor de cor para o parâmetro hbr , ele deverá ser uma das cores padrão do sistema (o valor 1 deve ser adicionado à cor escolhida). Por exemplo:


FillRect(hdc, &rect, (HBRUSH) (COLOR_WINDOW+1));

Para obter uma lista de todas as cores padrão do sistema, consulte GetSysColor.

Ao preencher o retângulo especificado, FillRect não inclui os lados direito e inferior do retângulo. A GDI preenche um retângulo até, mas não incluindo, a coluna direita e a linha inferior, independentemente do modo de mapeamento atual.

Exemplos

Para obter um exemplo, consulte Usando retângulos.

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
Conjunto de APIs	ext-ms-win-ntuser-gui-l1-1-0 (introduzido no Windows 8)