次の方法で共有


COLORMATCHSETUPA 構造体 (icm.h)

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

関連項目