PCMSCALLBACKW コールバック関数 (icm.h)
*PCMSCALLBACKW* (または ApplyCallbackFunction) は、 SetupColorMatchingW 関数によって表示されるダイアログ ボックスの実行中に WCS 構成データを更新するコールバック関数です。 ApplyCallbackFunction という名前はプレースホルダーです。 このコールバック関数の実際の名前は、ICM を使用してアプリケーションによって提供されます。
構文
PCMSCALLBACKW Pcmscallbackw;
BOOL Pcmscallbackw(
_tagCOLORMATCHSETUPW *unnamedParam1,
LPARAM unnamedParam2
)
{...}
パラメーター
unnamedParam1
WCS 構成データを含む COLORMATCHSETUPW 構造体へのポインター。
unnamedParam2
アプリケーションによって提供される値を格納します。
戻り値
この関数が成功した場合、戻り値は TRUE になります。
この関数が失敗した場合、戻り値は FALSE になります。 コールバック関数は 、SetLastError を呼び出すことによって拡張エラー情報を設定できます。
解説
ApplyCallbackFunction 関数は、[カラー管理] ダイアログ ボックスが表示されている間にデバイスの WCS 構成を変更するために使用されます。 [色の管理] ダイアログ ボックスは、 SetupColorMatchingW 関数によって表示されます。
コールバック関数が指定されている場合は、ダイアログ ボックスの右下に [適用 ] ボタンが表示されます。 [ 適用 ] ボタンを選択すると、コールバック関数によって設定されているデバイスの構成が直ちに更新されます。 [色の管理] ダイアログ ボックスは画面に残ります。
アプリケーションは、コールバック関数のアドレスを SetupColorMatchingW 関数に渡される COLORMATCHSETUPW 構造体に格納することで、WCS にコールバック関数を提供します。 このアドレスは、COLORMATCHSETUP 構造体の lPfnApplyCallback メンバーに格納されます。 dwFlags メンバーを CMS_USEAPPLYCALLBACK に設定する必要があります。または、コールバック関数は無視されます。
アプリケーションによって指定された値をコールバック関数に渡すことができます。 SetupColorMatchingW 関数を呼び出す前に、アプリケーションは COLORMATCHSETUPW 構造体の lParamApplyCallback メンバーに値を格納できます。 コールバック関数が呼び出されると、 lParamApplyCallback 構造体メンバーの値が 、その lParam パラメーターのコールバック関数に渡されます。
コールバック関数は完全に省略可能です。 指定されていない場合、[色の管理] ダイアログ ボックスに [適用 ] ボタンは表示されません。 Microsoft では、アプリケーションでコールバック関数を提供することを強くお勧めします。
要件
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
Header | icm.h |