Método ImageAttributes::SetColorMatrices (gdiplusimageattributes.h)

Artigo
08/24/2023

O método ImageAttributes::SetColorMatrices define a matriz de ajuste de cores e a matriz de ajuste de escala de cinza para uma categoria especificada.

Sintaxe

Status SetColorMatrices(
  [in]           const ColorMatrix *colorMatrix,
  [in]           const ColorMatrix *grayMatrix,
  [in, optional] ColorMatrixFlags  mode,
  [in, optional] ColorAdjustType   type
);

Parâmetros

[in] colorMatrix

Tipo: const ColorMatrix*

Ponteiro para uma matriz de ajuste de cor 5×5.

[in] grayMatrix

Tipo: const ColorMatrix*

Ponteiro para uma matriz de ajuste de escala de cinza 5×5.

[in, optional] mode

Tipo: ColorMatrixFlags

Elemento da enumeração ColorMatrixFlags que especifica o tipo de imagem e cor que serão afetados pelas matrizes de ajuste de cor e ajuste de escala de cinza. O valor padrão é ColorMatrixFlagsDefault.

[in, optional] type

Tipo: ColorAdjustType

Elemento da enumeração ColorAdjustType que especifica a categoria para a qual as matrizes de ajuste de cor e ajuste de escala de cinza são definidas. O valor padrão é ColorAdjustTypeDefault.

Retornar valor

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Um objeto ImageAttributes mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar matrizes de ajuste para a categoria padrão, matrizes de ajuste diferentes para a categoria de bitmap e matrizes de ajuste ainda diferentes para a categoria de caneta.

As configurações padrão de ajuste de cor e escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de caneta, as configurações padrão se aplicarão à categoria de caneta.

Assim que você especificar uma configuração de ajuste de escala de cinza ou cor para uma determinada categoria, as configurações de ajuste padrão não se aplicam mais a essa categoria. Por exemplo, suponha que você especifique uma coleção de configurações de ajuste para a categoria padrão. Se você definir as matrizes de ajuste de cor e ajuste de escala de cinza para a categoria de caneta passando ColorAdjustTypePen para o método ImageAttributes::SetColorMatrices , nenhuma das configurações de ajuste padrão será aplicada a canetas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP, 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	gdiplusimageattributes.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll