Bagikan melalui

Fungsi SetColorProfileElement (icm.h)

  • Artikel

Mengatur data elemen untuk elemen profil yang ditandai dalam profil warna ICC.

Sintaks

BOOL SetColorProfileElement(
  HPROFILE hProfile,
  TAGTYPE  tag,
  DWORD    dwOffset,
  PDWORD   pcbElement,
  PVOID    pElement
);

Parameter

hProfile

Menentukan handel ke profil ICC yang dimaksud.

tag

Mengidentifikasi elemen yang ditandai.

dwOffset

Menentukan offset dari byte pertama dari data elemen yang ditandai untuk mulai menulis.

pcbElement

Penunjuk ke variabel yang berisi jumlah byte data yang akan ditulis. Saat dikembalikan, berisi jumlah byte yang benar-benar ditulis.

pElement

Arahkan ke buffer yang berisi data untuk menulis ke elemen yang diberi tag di profil warna.

Mengembalikan nilai

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini akan gagal jika hProfile bukan profil ICC yang valid.

Jika profil warna tidak dibuka untuk izin baca/tulis, fungsi ini gagal.

Jika dwOffset melebihi ukuran yang ditetapkan untuk elemen bertag yang ditentukan, fungsi ini gagal.

Jika dwOffset + *pcbSize lebih besar dari ukuran elemen yang ditentukan, fungsi ini hanya menulis byte sebanyak yang akan sesuai dalam ukuran elemen saat ini.

Setiap data yang ada dalam bagian yang ditentukan dari elemen yang diberi tag ditimpa ketika fungsi ini berhasil.

Fungsi ini tidak mendukung profil Windows Color System (WCS) CAMP, DMP, dan GMMP; karena elemen profil secara implisit dikaitkan dengan dan dikodekan secara permanen ke jenis tag ICC dan ada banyak pustaka penguraian XML yang kuat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Header icm.h
Pustaka Mscms.lib
DLL Mscms.dll

Lihat juga