ImageAttributes::SetColorMatrix-Methode (gdiplusimageattributes.h)
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 |
Weitere Informationen
ImageAttributes::ClearColorMatrices
ImageAttributes::ClearColorMatrix
ImageAttributes::SetColorMatrices