Bagikan melalui

Fungsi SetICMProfileA (wingdi.h)

  • Artikel

Fungsi SetICMProfile menetapkan profil warna tertentu sebagai profil output untuk konteks perangkat (DC) tertentu.

Sintaks

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR lpFileName
);

Parameter

hdc

Menentukan konteks perangkat untuk mengatur profil warna.

lpFileName

Menentukan nama jalur profil warna yang akan disetel.

Nilai kembali

Jika fungsi ini berhasil, nilai yang dikembalikan adalah TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE.

Keterangan

SetICMProfile mengaitkan profil warna dengan konteks perangkat. Ini menjadi profil output untuk konteks perangkat tersebut. Profil warna tidak harus dikaitkan dengan perangkat tertentu. Profil independen perangkat seperti sRGB juga dapat digunakan. Jika profil warna tidak terkait dengan perangkat keras, profil tersebut akan dikembalikan oleh GetICMProfile, tetapi tidak oleh EnumICMProfiles.

Perhatikan bahwa di bawah Windows 95 atau yang lebih baru, driver perangkat PostScript untuk printer mengasumsikan model warna CMYK. Oleh karena itu, semua printer PostScript harus menggunakan profil warna CMYK. Windows 2000 tidak memiliki batasan ini.

SetICMProfile hanya mendukung profil RGB di DC yang kompatibel.

Windows 95/98/Me: SetICMProfileW didukung oleh Lapisan Microsoft untuk Unicode. Untuk menggunakan ini, Anda harus menambahkan file tertentu ke aplikasi Anda, seperti yang diuraikan dalam Microsoft Layer untuk Unicode pada Sistem Windows 95/98/Me.

Catatan

Header wingdi.h mendefinisikan SetICMProfile sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header wingdi.h
Pustaka Gdi32.lib
DLL Gdi32.dll

Lihat juga