次の方法で共有

ColorMatchToTarget 関数 (wingdi.h)

  • [アーティクル]

ColorMatchToTarget 関数を使用すると、ターゲット デバイスに表示される色をプレビューできます。

構文

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

パラメーター

hdc

プレビューのデバイス コンテキスト (通常は画面) を指定します。

hdcTarget

ターゲット デバイス コンテキスト (通常はプリンター) を指定します。

action

次のいずれかの値を持つ定数。

 

値 意味
CS_ENABLE
 色をターゲット デバイスの色域にマップします。 これにより、色校正が可能になります。 DC に対する後続の描画コマンドはすべて、ターゲット デバイスに表示される色と同じようにレンダリングされます。
CS_DISABLE
 色校正を無効にします。
CS_DELETE_TRANSFORM
 ターゲット プロファイルに対してカラー管理が有効になっている場合は、無効にして、連結された変換を削除します。

戻り値

この関数が成功した場合、戻り値は TRUE になります。

この関数が失敗した場合、戻り値は FALSE になります。

注釈

ColorMatchToTarget を使用すると、別のカラー出力デバイスでカラー出力デバイスの色を証明できます。 uiAction パラメーターを CS_ENABLE に設定すると、後続のすべての描画コマンドが DC に表示され、ターゲット デバイスに表示される色がレンダリングされます。 uiAction が CS_DISABLE に設定されている場合、校正はオフになります。 ただし、現在のカラー変換は DC から削除されません。 これは非アクティブです。

ColorMatchToTarget が呼び出されると、ターゲット デバイスの色変換が最初に実行され、プレビュー デバイスへの変換が最初の変換の結果に適用されます。 これは主に、色域マッピングの条件を確認するために使用されます。 この関数を使用する前に、両方のデバイス コンテキストで WCS を有効にする必要があります。

この関数をカスケードすることはできません。 uiAction を CS_ENABLE に設定することでターゲットへのカラー マッピングが有効になっている間、色空間または色域マッピング メソッドに対するアプリケーションの変更は無視されます。 これらの変更は、ターゲットへのカラー マッピングが無効になっている場合に有効になります。

メモ アプリケーションが CS_DELETE_TRANSFORM を使用して変換を削除しない場合、メモリ リークは発生しません。 変換は、デバイス コンテキスト (DC) が閉じているか、アプリケーションの色空間が削除されたときに削除されます。 ただし、変換を再度使用しない場合、またはアプリケーションが DC でこれ以上カラー マッチングを実行しない場合は、変換を明示的に削除して、その変換が占有するメモリを解放する必要があります。
 
uiAction パラメーターは、ColorMatchToTarget 関数が呼び出される前にカラー管理が有効になっている場合にのみ、CS_DELETE_TRANSFORMに設定する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h
Library Gdi32.lib
[DLL] Gdi32.dll

こちらもご覧ください