Função DrawThemeEdge (uxtheme.h)

Artigo
08/26/2023

Desenha uma ou mais bordas definidas pelo estilo visual de um retângulo.

Sintaxe

HRESULT DrawThemeEdge(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCRECT pDestRect,
  [in]  UINT    uEdge,
  [in]  UINT    uFlags,
  [out] LPRECT  pContentRect
);

Parâmetros

[in] hTheme

Tipo: HTHEME

Manipule para os dados de tema especificados de uma janela. Use OpenThemeData para criar um HTHEME.

[in] hdc

Tipo: HDC

HDC.

[in] iPartId

Tipo: int

Valor do tipo int que especifica a parte que contém o retângulo. Consulte Partes e Estados.

[in] iStateId

Tipo: int

Valor do tipo int que especifica o estado da parte. Consulte Partes e Estados.

[in] pDestRect

Tipo: LPCRECT

Ponteiro para uma estrutura RECT que contém, em coordenadas lógicas, o retângulo.

[in] uEdge

Tipo: UINT

UINT que especifica 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 ou um dos sinalizadores de combinação. Os sinalizadores de borda são:

Valor	Significado
BDR_RAISEDINNER	Borda interna elevada
BDR_SUNKENINNER	Borda interna submersa
BDR_RAISEDOUTER	Borda externa elevada
BDR_SUNKENOUTER	Borda externa submersa
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] uFlags

Tipo: UINT

UINT que especifica o tipo de borda a ser desenhada. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
BF_ADJUST	O retângulo apontado pelo parâmetro pDestRect é reduzido para excluir as bordas que foram desenhadas; caso contrário, o retângulo não será alterado.
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 é o canto superior direito.
BF_DIAGONAL_ENDBOTTOMRIGHT	Borda diagonal. O ponto final é o canto inferior direito do retângulo; a origem é o canto superior esquerdo.
BF_DIAGONAL_ENDTOPLEFT	Borda diagonal. O ponto final é o canto superior esquerdo do retângulo; a origem é o canto inferior direito.
BF_DIAGONAL_ENDTOPRIGHT	Borda diagonal. O ponto final é o canto superior direito do retângulo; a origem é o canto inferior esquerdo.
BF_FLAT	Borda plana.
BF_LEFT	Lado esquerdo do retângulo de borda.
BF_MIDDLE	O interior do retângulo deve 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.

[out] pContentRect

Tipo: LPRECT

Ponteiro para uma estrutura RECT que contém, em coordenadas lógicas, o retângulo que recebe o retângulo interior, se uFlags estiver definido como BF_ADJUST. Esse parâmetro pode ser definido como NULL.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	uxtheme.h
Biblioteca	UxTheme.lib
DLL	UxTheme.dll

Confira também

Identificadores de propriedade

Compartilhar via