Estrutura EMRGRADIENTFILL (wingdi.h)

Artigo
03/13/2024

A estrutura EMRGRADIENTFILL contém membros para o registro de metafile avançado GradientFill .

Sintaxe

typedef struct tagEMRGRADIENTFILL {
  EMR       emr;
  RECTL     rclBounds;
  DWORD     nVer;
  DWORD     nTri;
  ULONG     ulMode;
  TRIVERTEX Ver[1];
} EMRGRADIENTFILL, *PEMRGRADIENTFILL;

Membros

emr

A estrutura base para todos os tipos de registro.

rclBounds

O retângulo delimitador, em unidades de dispositivo.

nVer

O número de vértices.

nTri

O número de retângulos ou triângulos a serem passados para GradientFill.

ulMode

O modo de preenchimento gradiente. Esse membro pode ser um dos valores a seguir.

Valor	Significado
GRADIENT_FILL_RECT_H	Nesse modo, dois pontos de extremidade descrevem um retângulo. O retângulo é definido para ter uma cor constante (especificada pela estrutura TRIVERTEX ) para as bordas esquerda e direita. A GDI interpola a cor da borda esquerda para a direita e preenche o interior.
GRADIENT_FILL_RECT_V	Nesse modo, dois pontos de extremidade descrevem um retângulo. O retângulo é definido para ter uma cor constante (especificada pela estrutura TRIVERTEX ) para as bordas superior e inferior. A GDI interpola a cor da borda superior para inferior e preenche o interior.
GRADIENT_FILL_TRIANGLE	Nesse modo, uma matriz de estruturas TRIVERTEX é passada para a GDI juntamente com uma lista de índices de matriz que descrevem triângulos separados. O GDI executa a interpolação linear entre vértices de triângulo e preenche o interior. O desenho é feito diretamente nos modos 24 e 32 bpp. O dithering é executado no modo 16, 8, 4 e 1 bpp.

Ver[1]

Uma matriz de estruturas TRIVERTEX que definem cada um um vértice.

Comentários

Essa é uma estrutura de comprimento variável. O membro Ver designa o início da área de comprimento variável. Primeiro vem uma matriz de estruturas TRIVERTEXnVer para passar os vértices. Em seguida, vem uma matriz de estruturas nTriGRADIENT_TRIANGLE ou nTriGRADIENT_RECT estruturas, dependendo do valor de ulMode (triângulos ou retângulos).

Essa estrutura deve ser usada durante a reprodução do metarquivo.

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]
Cabeçalho	wingdi.h (inclua Windows.h)