Bagikan melalui

Fungsi SetICMProfileW (wingdi.h)

  • Artikel

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

Sintaksis

BOOL SetICMProfileW(
  HDC    hdc,
  LPWSTR lpFileName
);

Parameter

hdc

Menentukan konteks perangkat untuk mengatur profil warna.

lpFileName

Menentukan nama jalur profil warna yang akan diatur.

Mengembalikan nilai

Jika fungsi ini berhasil, nilai pengembalian TRUE.

Jika fungsi ini gagal, nilai yang dikembalikan adalah FALSE.

Komentar

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 dengan 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 for Unicode pada Windows 95/98/Me Systems.

Nota

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

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

Lihat juga

  • konsep manajemen warna dasar
  • Functions
  • EnumICMProfilesW
  • GetICMProfileW