COLORMATCHSETUPA 構造体 (icm.h)

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

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

構文

typedef struct _tagCOLORMATCHSETUPA {
  DWORD         dwSize;
  DWORD         dwVersion;
  DWORD         dwFlags;
  HWND          hwndOwner;
  PCSTR         pSourceName;
  PCSTR         pDisplayName;
  PCSTR         pPrinterName;
  DWORD         dwRenderIntent;
  DWORD         dwProofingIntent;
  PSTR          pMonitorProfile;
  DWORD         ccMonitorProfile;
  PSTR          pPrinterProfile;
  DWORD         ccPrinterProfile;
  PSTR          pTargetProfile;
  DWORD         ccTargetProfile;
  DLGPROC       lpfnHook;
  LPARAM        lParam;
  PCMSCALLBACKA lpfnApplyCallback;
  LPARAM        lParamApplyCallback;
} COLORMATCHSETUPA, *PCOLORMATCHSETUPA, *LPCOLORMATCHSETUPA;

メンバー

dwSize

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

dwVersion

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

dwFlags

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

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

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

フラグ	説明
CMS_DISABLEICM	このフラグを入力時に設定すると、[カラー管理を有効にする] チェックボックスがオフになり、他のすべてのコントロールが無効になります。終了時に設定した場合、ユーザーは色管理を実行したくないことを意味します。
CMS_ENABLEPROOFING	このフラグを入力時に設定すると、校正コントロールが有効になり、[校正チェック] ボックスがオンになっていることを示します。終了時に設定すると、ユーザーは選択したプリンターとは異なるターゲットデバイスの色管理を実行することを意味します。
CMS_SETRENDERINTENT	エントリに設定されている場合、このフラグは、dwRenderIntent メンバーに、Rendering Intent コントロールの初期化に使用する値が含まれていることを示します。それ以外の場合、コントロールは既定で Picture レンダリングに設定されます。 WCS が有効になっている場合、このフラグは終了時に設定されます。
CMS_SETPROOFINTENT	CMS_ENABLEPROOFINGも設定されていない限り無視されます。 entry に設定され、CMS_ENABLEPROOFINGも設定されている場合、このフラグは dwProofingIntent メンバーを使用して Target Rendering Intent コントロールを初期化することを示します。それ以外の場合、コントロールは既定で Picture レンダリングに設定されます。校正が有効になっている場合、このフラグは終了時に設定されます。
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

次の方法で共有

COLORMATCHSETUPA 構造体 (icm.h)

構文

メンバー

要件

関連項目

フィードバック

その他のリソース