Metode ImageAttributes::SetColorMatrix (gdiplusimageattributes.h)

Artikel
08/24/2023

Metode ImageAttributes::SetColorMatrix mengatur matriks penyesuaian warna untuk kategori tertentu.

Sintaks

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

Parameter

[in] colorMatrix

Jenis: const ColorMatrix*

Penunjuk ke matriks penyesuaian warna 5×5.

[in] mode

Jenis: ColorMatrixFlags

Elemen enumerasi ColorMatrixFlags yang menentukan jenis gambar dan warna yang akan dipengaruhi oleh matriks penyesuaian warna.

[in, optional] type

Jenis: ColorAdjustType

Elemen enumerasi ColorAdjustType yang menentukan kategori tempat matriks penyesuaian warna diatur. Nilai defaultnya adalah ColorAdjustTypeDefault.

Nilai kembali

Jenis: Status

Jika metode berhasil, metode mengembalikan Ok, yang merupakan elemen dari enumerasi Status .

Jika metode gagal, metode mengembalikan salah satu elemen lain dari enumerasi Status .

Keterangan

Objek ImageAttributes mempertahankan pengaturan warna dan skala abu-abu untuk lima kategori penyesuaian: default, bitmap, kuas, pena, dan teks. Misalnya, Anda dapat menentukan matriks penyesuaian warna untuk kategori default, matriks penyesuaian warna yang berbeda untuk kategori bitmap, dan masih matriks penyesuaian warna yang berbeda untuk kategori pena.

Pengaturan penyesuaian warna dan abu-abu default berlaku untuk semua kategori yang tidak memiliki pengaturan penyesuaian sendiri. Misalnya, jika Anda tidak pernah menentukan pengaturan penyesuaian apa pun untuk kategori pena, maka pengaturan default berlaku untuk kategori pena.

Segera setelah Anda menentukan pengaturan penyesuaian warna atau abu-abu untuk kategori tertentu, pengaturan penyesuaian default tidak lagi berlaku untuk kategori tersebut. Misalnya, Anda menentukan kumpulan pengaturan penyesuaian untuk kategori default. Jika Anda mengatur matriks penyesuaian warna untuk kategori pena dengan meneruskan ColorAdjustTypePen ke metode ImageAttributes::SetColorMatrix , maka tidak ada pengaturan penyesuaian default yang akan berlaku untuk pena.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusimageattributes.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll