次の方法で共有

SetICMProfileA 関数 (wingdi.h)

  • [アーティクル]

SetICMProfile 関数は、指定したカラー プロファイルを、指定したデバイス コンテキスト (DC) の出力プロファイルとして設定します。

構文

BOOL SetICMProfileA(
  HDC   hdc,
  LPSTR 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の Unicode 用 Microsoft Layer で説明されているように、特定のファイルをアプリケーションに追加する必要があります。

手記

wingdi.h ヘッダーは、SetICMProfile をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目