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 |