Função DrawEdge (winuser.h)

Artigo
03/15/2023

A função DrawEdge desenha uma ou mais bordas do retângulo.

Sintaxe

BOOL DrawEdge(
  [in]      HDC    hdc,
  [in, out] LPRECT qrc,
  [in]      UINT   edge,
  [in]      UINT   grfFlags
);

Parâmetros

[in] hdc

Um identificador para o contexto do dispositivo.

[in, out] qrc

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

[in] edge

O tipo de bordas internas e externas a serem desenhadas. Esse parâmetro deve ser uma combinação de um sinalizador de borda interna e um sinalizador de borda externa. Os sinalizadores de borda interna são os seguintes.

Valor	Significado
BDR_RAISEDINNER	Borda interna elevada.
BDR_SUNKENINNER	Borda interna submersa.

Os sinalizadores de borda externa são os seguintes.

Valor	Significado
BDR_RAISEDOUTER	Borda externa elevada.
BDR_SUNKENOUTER	Borda externa submersa.

Como alternativa, o parâmetro de borda pode especificar um dos sinalizadores a seguir.

Valor	Significado
EDGE_BUMP	Combinação de BDR_RAISEDOUTER e BDR_SUNKENINNER.
EDGE_ETCHED	Combinação de BDR_SUNKENOUTER e BDR_RAISEDINNER.
EDGE_RAISED	Combinação de BDR_RAISEDOUTER e BDR_RAISEDINNER.
EDGE_SUNKEN	Combinação de BDR_SUNKENOUTER e BDR_SUNKENINNER.

[in] grfFlags

O tipo de borda. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
BF_ADJUST	Se esse sinalizador for passado, reduza o retângulo apontado pelo parâmetro qrc para excluir as bordas que foram desenhadas. Se esse sinalizador não for passado, não altere o retângulo apontado pelo parâmetro qrc .
BF_BOTTOM	Parte inferior do retângulo de borda.
BF_BOTTOMLEFT	Parte inferior e esquerda do retângulo de borda.
BF_BOTTOMRIGHT	Parte inferior e direita do retângulo de borda.
BF_DIAGONAL	Borda diagonal.
BF_DIAGONAL_ENDBOTTOMLEFT	Borda diagonal. O ponto final é o canto inferior esquerdo do retângulo; a origem é canto superior direito.
BF_DIAGONAL_ENDBOTTOMRIGHT	Borda diagonal. O ponto final é o canto inferior direito do retângulo; a origem é canto superior esquerdo.
BF_DIAGONAL_ENDTOPLEFT	Borda diagonal. O ponto final é o canto superior esquerdo do retângulo; a origem é canto inferior direito.
BF_DIAGONAL_ENDTOPRIGHT	Borda diagonal. O ponto final é o canto superior direito do retângulo; a origem é canto inferior esquerdo.
BF_FLAT	Borda plana.
BF_LEFT	Lado esquerdo do retângulo de borda.
BF_MIDDLE	Interior do retângulo a ser preenchido.
BF_MONO	Borda unidimensional.
BF_RECT	Retângulo de borda inteira.
BF_RIGHT	Lado direito do retângulo de borda.
BF_SOFT	Botões macios em vez de blocos.
BF_TOP	Parte superior do retângulo de borda.
BF_TOPLEFT	Parte superior e esquerda do retângulo de borda.
BF_TOPRIGHT	Parte superior e direita do retângulo de 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.

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-draw-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Funções de pintura e desenho

Visão geral de pintura e desenho

RECT

Compartilhar via