Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
Weitere Informationen
ImageAttributes::ClearColorMatrices
ImageAttributes::ClearColorMatrix
ImageAttributes::SetColorMatrix