ImageAttributes::SetColorMatrix-Methode (gdiplusimageattributes.h)

Artikel
02/26/2024

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

Syntax

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

Parameter

[in] colorMatrix

Typ: const ColorMatrix*

Zeiger auf eine 5×5-Farbanpassungsmatrix.

[in] mode

Typ: ColorMatrixFlags

Element der ColorMatrixFlags-Enumeration , das den Typ des Bilds und der Farbe angibt, die von der Farbanpassungsmatrix beeinflusst werden.

[in, optional] type

Typ: ColorAdjustType

Element der ColorAdjustType-Enumeration , das die Kategorie angibt, für die die Farbanpassungsmatrix festgelegt ist. 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 eine Farbanpassungsmatrix für die Standardkategorie, eine andere Farbanpassungsmatrix für die Bitmapkategorie und weiterhin eine andere Farbanpassungsmatrix 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 Farbanpassungsmatrix für die Stiftkategorie festlegen, indem Sie ColorAdjustTypePen an die ImageAttributes::SetColorMatrix-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