SetICMProfileW 関数 (wingdi.h)
SetICMProfile 関数は、指定したカラー プロファイルを、指定したデバイス コンテキスト (DC) の出力プロファイルとして設定します。
構文
BOOL SetICMProfileW(
HDC hdc,
LPWSTR lpFileName
);
パラメーター
hdc
カラー プロファイルを設定するデバイス コンテキストを指定します。
lpFileName
設定するカラー プロファイルのパス名を指定します。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。
注釈
SetICMProfile は、カラー プロファイルをデバイス コンテキストに関連付けます。 そのデバイス コンテキストの出力プロファイルになります。 カラー プロファイルは、特定のデバイスに関連付ける必要はありません。 sRGB などのデバイスに依存しないプロファイルも使用できます。 カラー プロファイルがハードウェア デバイスに関連付けられていない場合は、 GetICMProfile によって返されますが、 EnumICMProfiles からは返されません。
Windows 95 以降では、プリンター用の PostScript デバイス ドライバーでは CMYK カラー モデルが想定されていることに注意してください。 したがって、すべての PostScript プリンターで CMYK カラー プロファイルを使用する必要があります。 Windows 2000 には、この制限はありません。
SetICMProfile では、互換性のある DC の RGB プロファイルのみがサポートされます。
Windows 95/98/Me: SetICMProfileW は、Microsoft Layer for Unicode でサポートされています。 これを使用するには、「 Windows 95/98/Me Systems の Microsoft Layer for Unicode」で説明されているように、特定のファイルをアプリケーションに追加する必要があります。
注意
wingdi.h ヘッダーは、SETICMProfile をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |