Função FrameRect (winuser.h)

Artigo
03/13/2024

A função FrameRect desenha uma borda ao redor do retângulo especificado usando o pincel especificado. A largura e a altura da borda são sempre uma unidade lógica.

Sintaxe

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

Parâmetros

[in] hDC

Um identificador para o contexto do dispositivo no qual a borda é desenhada.

[in] lprc

Um ponteiro para uma estrutura RECT que contém as coordenadas lógicas dos cantos superior esquerdo e inferior direito do retângulo.

[in] hbr

Um identificador para o pincel usado para desenhar a borda.

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 deve ter sido criado usando a função CreateHatchBrush, CreatePatternBrush ou CreateSolidBrush ou recuperado usando a função GetStockObject .

Se o membro inferior da estrutura RECT for menor que o membro superior ou se o membro direito for menor que o membro esquerdo , a função não desenhará o retângulo.

Requisitos

Requisito	Valor
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-1 (introduzido em Windows 8.1)