ImageAttributes::SetColorMatrices-Methode (gdiplusimageattributes.h)

Artikel
03/01/2024

Die ImageAttributes::SetColorMatrices-Methode legt die Farbanpassungsmatrix und die Graustufenanpassungsmatrix für eine angegebene Kategorie fest.

Syntax

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

Parameter

[in] colorMatrix

Typ: const ColorMatrix*

Zeiger auf eine 5×5-Farbanpassungsmatrix.

[in] grayMatrix

Typ: const ColorMatrix*

Zeiger auf eine 5×5 Graustufenanpassungsmatrix.

[in, optional] mode

Typ: ColorMatrixFlags

Element der ColorMatrixFlags-Enumeration , das den Typ des Bilds und der Farbe angibt, die von den Farbanpassungs- und Graustufenanpassungsmatrizen beeinflusst werden. Der Standardwert ist ColorMatrixFlagsDefault.

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Farbanpassungs- und Graustufenanpassungsmatrizen festgelegt sind. Der Standardwert ist ColorAdjustTypeDefault.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.

Hinweise

Ein ImageAttributes-Objekt verwaltet Farb- und Graustufeneinstellungen für fünf Anpassungskategorien: Standard, Bitmap, Pinsel, Stift und Text. Sie können beispielsweise Anpassungsmatrizen für die Standardkategorie, verschiedene Anpassungsmatrizen für die Bitmapkategorie und noch unterschiedliche Anpassungsmatrizen für die Stiftkategorie angeben.

Die Standardeinstellungen für Farb- und Graustufenanpassung gelten für alle Kategorien, die keine eigenen Anpassungseinstellungen haben. Wenn Sie beispielsweise nie Anpassungseinstellungen für die Stiftkategorie angeben, gelten die Standardeinstellungen für die Stiftkategorie.

Sobald Sie eine Farb- oder Graustufenanpassungseinstellung für eine bestimmte Kategorie angeben, gelten die Standardeinstellungseinstellungen nicht mehr für diese Kategorie. Angenommen, Sie geben eine Sammlung von Anpassungseinstellungen für die Standardkategorie an. Wenn Sie die Farbanpassungs- und Graustufenanpassungsmatrizen für die Stiftkategorie festlegen, indem Sie ColorAdjustTypePen an die ImageAttributes::SetColorMatrices-Methode übergeben, gilt keine der Standardanpassungseinstellungen für Stifte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusimageattributes.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll