COLORMATCHSETUPW 構造体 (icm.h)

[アーティクル]
08/24/2023

COLORMATCHSETUP 構造体には、SetupColorMatchingW 関数が ColorManagement ダイアログボックスの初期化に使用する情報が含まれています。ユーザーがダイアログボックスを閉じると、 SetupColorMatching は、この構造体でのユーザーの選択に関する情報を返します。

構文

typedef struct _tagCOLORMATCHSETUPW {
  DWORD         dwSize;
  DWORD         dwVersion;
  DWORD         dwFlags;
  HWND          hwndOwner;
  PCWSTR        pSourceName;
  PCWSTR        pDisplayName;
  PCWSTR        pPrinterName;
  DWORD         dwRenderIntent;
  DWORD         dwProofingIntent;
  PWSTR         pMonitorProfile;
  DWORD         ccMonitorProfile;
  PWSTR         pPrinterProfile;
  DWORD         ccPrinterProfile;
  PWSTR         pTargetProfile;
  DWORD         ccTargetProfile;
  DLGPROC       lpfnHook;
  LPARAM        lParam;
  PCMSCALLBACKW lpfnApplyCallback;
  LPARAM        lParamApplyCallback;
} COLORMATCHSETUPW, *PCOLORMATCHSETUPW, *LPCOLORMATCHSETUPW;

メンバー

dwSize

構造体のサイズ。 sizeof ( COLORMATCHSETUP ) に設定する必要があります。

dwVersion

COLORMATCHSETUP 構造体のバージョン。これはCOLOR_MATCH_VERSIONに設定する必要があります。

dwFlags

ダイアログボックスの初期化に使用されるビットフラグのセット。エントリ時に 0 に設定すると、すべてのコントロールは既定の状態を想定します。

ダイアログボックスが戻ると、これらのフラグはユーザーの入力を示すように設定されます。

このメンバーは、次のフラグの組み合わせを使用して設定できます。

フラグ	説明
CMS_DISABLEICM	入力時に設定した場合、このフラグは [色管理を有効にする] チェックボックスがオフになっていることを示し、他のすべてのコントロールを無効にします。終了時に設定した場合、ユーザーは色管理を実行したくないことを意味します。
CMS_ENABLEPROOFING	入力時に設定した場合、このフラグは校正コントロールを有効にし、[校正チェック] ボックスがオンになっていることを示します。終了時に設定した場合、ユーザーは選択したプリンターとは異なるターゲットデバイスのカラー管理を実行することを意味します。
CMS_SETRENDERINTENT	エントリに設定されている場合、このフラグは、dwRenderIntent メンバーに、Rendering Intent コントロールの初期化に使用する値が含まれていることを示します。それ以外の場合、コントロールの既定値は [図のレンダリング] になります。 WCS が有効になっている場合、このフラグは終了時に設定されます。
CMS_SETPROOFINTENT	CMS_ENABLEPROOFINGも設定されていない限り、無視されます。 entry に設定され、CMS_ENABLEPROOFINGも設定されている場合、このフラグは dwProofingIntent メンバーを使用して Target Rendering Intent コントロールを初期化することを示します。それ以外の場合、コントロールの既定値は [図のレンダリング] になります。校正が有効になっている場合、このフラグは終了時に設定されます。
CMS_SETMONITORPROFILE	エントリに設定されている場合、このフラグは、pMonitorProfile メンバーで指定された色管理プロファイルがモニタープロファイルコントロールの最初の選択であることを示します。指定したプロファイルがモニターに関連付けられていない場合、このフラグは無視され、モニターの既定のプロファイルが使用されます。
CMS_SETPRINTERPROFILE	エントリに設定されている場合、このフラグは、pPrinterProfile メンバーで指定されたカラー管理プロファイルがプリンタープロファイルコントロールの最初の選択であることを示します。指定したプロファイルがプリンターに関連付けられていない場合、このフラグは無視され、プリンターの既定のプロファイルが使用されます。
CMS_SETTARGETPROFILE	エントリに設定されている場合、このフラグは、pTargetProfile メンバーで指定されたカラープロファイルがターゲットプロファイルコントロールの最初の選択であることを示します。指定したプロファイルがインストールされていない場合、このフラグは無視され、プリンターの既定のプロファイルが使用されます。プリンターに既定のプロファイルがない場合は、最初のプロファイルがアルファベット順に表示されます。
CMS_USEHOOK	このフラグは、 lpfnHook メンバーにフックプロシージャのアドレスが含まれていること、および lParam メンバーに、WM_INITDIALOG メッセージの送信時にフックプロシージャに渡される値が含まれていることを指定します。
CMS_MONITOROVERFLOW	カラー管理を有効にし、 ccMonitorProfile で指定されたバッファーサイズが選択したプロファイル名に対して不十分な場合、このフラグは終了時に設定されます。このような場合、GetLastError はERROR_INSUFFICIENT_BUFFERを返します。
CMS_PRINTERROVERFLOW	カラー管理を有効にし、 ccPrinterProfile で指定されたバッファーサイズが選択したプロファイル名に対して不十分な場合、このフラグは終了時に設定されます。このような場合、GetLastError はERROR_INSUFFICIENT_BUFFERを返します。
CMS_TARGETOVERFLOW	校正を有効にし、 ccTargetProfile で指定されたバッファーサイズが選択したプロファイル名に対して不十分な場合、このフラグは終了時に設定されます。このような場合、GetLastError はERROR_INSUFFICIENT_BUFFERを返します。
CMS_USEAPPLYCALLBACK	エントリに設定されている場合、このフラグは、SetupColorMatching 関数が関数 PCMSCALLBACKW を呼び出す必要があることを示します。コールバック関数のアドレスは lpfnApplyCallback に含まれています。
CMS_USEDESCRIPTION	エントリに設定されている場合、このフラグは、プロファイル記述タグに含まれるプロファイルの説明を取得するように SetupColorMatching 関数に指示します (「ICC プロファイル形式仕様 v3.4」を参照)。 [カラー管理] の一般的なダイアログボックスの [モニタープロファイル]、[プリンタープロファイル]、[エミュレートされたデバイスプロファイル] の編集ボックスに挿入されます。

hwndOwner

ダイアログボックスの所有者に対するウィンドウハンドル。ダイアログボックスに所有者がない場合は NULL 。

pSourceName

カラー管理を実行する項目のソースプロファイルを記述する、アプリケーション指定の文字列へのポインター。これが NULL の場合、イメージソースコントロールには Windows の既定のカラープロファイルの名前が表示されます。

pDisplayName

カラー管理に使用するモニターに名前を付ける文字列を指します。これが有効なモニターの名前でない場合は、最初に列挙されたモニターが使用されます。

pPrinterName

イメージをレンダリングするプリンターに名前を付ける文字列を指します。これが有効なプリンター名でない場合は、ダイアログで既定のプリンターが使用され、名前が付けられます。

dwRenderIntent

必要な色管理の種類。有効な値は次のとおりです。

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

詳細については、「意図のレンダリング」を参照してください。

dwProofingIntent

校正済みイメージに必要な色管理の種類。有効な値は次のとおりです。

INTENT_PERCEPTUAL

INTENT_SATURATION

INTENT_RELATIVE_COLORIMETRIC

INTENT_ABSOLUTE_COLORIMETRIC

詳細については、「意図のレンダリング」を参照してください。

pMonitorProfile

ユーザーが選択したモニタープロファイルの名前を配置するバッファーへのポインター。 CMS_SETMONITORPROFILE フラグを使用する場合は、このフラグを使用して、ダイアログが最初に表示されるときに、モニターの既定値以外のプロファイルを選択することもできます。

ccMonitorProfile

pMonitorProfile メンバーが指すバッファーのサイズ (文字数)。バッファーが選択した名前を保持するのに十分な大きさでない場合、名前はこのサイズに切り捨てられ、ERROR_INSUFFICIENT_BUFFERが返されます。 MAX_PATH サイズのバッファーは常に機能します。

pPrinterProfile

ユーザーが選択したプリンタープロファイルの名前を配置するバッファーを指します。 CMS_SETPRINTERPROFILE フラグを使用する場合は、このフラグを使用して、ダイアログが最初に表示されるときにプリンターの既定値以外のプロファイルを選択することもできます。

ccPrinterProfile

pPrinterProfile メンバーが指すバッファーのサイズ (文字数)。バッファーが選択した名前を保持するのに十分な大きさでない場合、名前はこのサイズに切り捨てられ、ERROR_INSUFFICIENT_BUFFERが返されます。 MAX_PATH サイズのバッファーは常に機能します。

pTargetProfile

校正用にユーザーが選択したターゲットプロファイルの名前を配置するバッファーを指します。 CMS_SETTARGETPROFILE フラグを使用する場合は、このフラグを使用して、ダイアログが最初に表示されるときにプリンターの既定値以外のプロファイルを選択することもできます。

ccTargetProfile

pTargetProfile メンバーが指すバッファーのサイズ (文字数)。バッファーが選択した名前を保持するのに十分な大きさでない場合、名前はこのサイズに切り捨てられ、ERROR_INSUFFICIENT_BUFFERが返されます。 MAX_PATH サイズのバッファーは常に機能します。

lpfnHook

CMS_USEHOOK フラグが設定されている場合、このメンバーはダイアログのメッセージをフィルター処理または処理できるダイアログプロシージャのアドレスです ( DialogProc を参照)。フックプロシージャは、WM_INITDIALOG前に発行されたメッセージを受信しません。これは、システム指定のダイアログプロシージャがメッセージを処理した後、WM_INITDIALOG メッセージで呼び出されます。その他のすべてのメッセージでは、フック・プロシージャーはシステム指定プロシージャーの前にメッセージを受け取ります。フックプロシージャがこれらのメッセージに TRUE を 返した場合、システム指定のプロシージャは呼び出されません。

フックプロシージャは EndDialog 関数を呼び出す場合があります。

lParam

CMS_USEHOOK フラグが設定されている場合、このメンバーは、WM_INITDIALOG メッセージの処理時に lParam パラメーターとしてアプリケーション指定のフックプロシージャに渡されます。

lpfnApplyCallback

[色の管理] ダイアログボックスの [ 適用 ] ボタンが選択されたときに呼び出されるコールバック関数へのポインターが含まれます。コールバック関数が指定されていない場合は、このメンバーを NULL に設定する必要があります。 「PCMSCALLBACKW」を参照してください。

lParamApplyCallback

lParam パラメーターを介して関数 ApplyCallbackFunction に渡される値を格納します。値の意味と内容は、アプリケーションによって指定されます。

要件


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	icm.h

次の方法で共有

COLORMATCHSETUPW 構造体 (icm.h)

構文

メンバー

要件

関連項目

フィードバック

その他のリソース