Função FillRect (winuser.h)
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) |