Metode ImageAttributes::ClearOutputChannelColorProfile (gdiplusimageattributes.h)

Artikel
08/24/2023

Metode ImageAttributes::ClearOutputChannelColorProfile menghapus pengaturan profil warna saluran output untuk kategori tertentu.

Sintaks

Status ClearOutputChannelColorProfile(
  [in, optional] ColorAdjustType type
);

Parameter

[in, optional] type

Jenis: ColorAdjustType

Elemen enumerasi ColorAdjustType yang menentukan kategori di mana pengaturan profil saluran output dibersihkan. Nilai defaultnya adalah ColorAdjustTypeDefault.

Menampilkan nilai

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 profil saluran output untuk kategori default dan profil saluran output yang berbeda untuk kategori bitmap.

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 bitmap, maka pengaturan default berlaku untuk kategori bitmap.

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 profil saluran output dan matriks penyesuaian untuk kategori default. Jika Anda mengatur profil saluran output untuk kategori bitmap dengan memanggil ImageAttributes::SetOutputChannelColorProfile, profil saluran output default tidak akan berlaku untuk bitmap. Jika nanti Anda menghapus profil saluran output bitmap dengan memanggil ImageAttributes::ClearOutputChannelColorProfile, kategori bitmap tidak akan kembali ke profil saluran output default; sebaliknya, kategori bitmap tidak akan memiliki pengaturan profil saluran output. Demikian pula, kategori bitmap tidak akan kembali ke matriks penyesuaian warna default; sebaliknya, kategori bitmap tidak akan memiliki matriks penyesuaian warna.

Persyaratan


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