_CPSUICALLBACKコールバック関数 (compstui.h)

_CPSUICALLBACK関数の種類は、CPSUI アプリケーション (プリンター インターフェイス DLL を含む) によって、CPSUI メッセージ ハンドラーとして使用されるコールバック関数を定義するために使用されます。

構文

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

パラメーター

pCPSUICBParam

CPSUICBPARAM 構造体への CPSUI 提供のポインター。

戻り値

_CPSUICALLBACK型指定されたコールバック関数は、次の表に示す値のいずれかを返す必要があります。 各値は、CPSUI が実行する必要があるアクションを示します。

リターン コード 説明
CPSUICB_ACTION_ITEMS_APPLIED CPSUICBPARAM 構造体の Reason メンバーがCPSUICB_REASON_APPLYNOWに設定され、コールバック関数が現在のオプション値を正常に処理しました。
CPSUICB_ACTION_NO_APPLY_EXIT CPSUICBPARAM 構造体の Reason メンバーがCPSUICB_REASON_APPLYNOWに設定されましたが、コールバック関数が無効または互換性のないオプション値を検出しました。 コールバック関数は、問題をユーザーに伝えるダイアログ ボックスを表示する必要があります。
CPSUICB_ACTION_NONE CPSUI によるアクションは必要ありません。
CPSUICB_ACTION_OPTIF_CHANGED コールバック関数は、選択したオプションが変更されたか、または別のOPTFプレフィックス付きフラグが変更されたことを示すために、 OPTITEM 構造体のOPTIF_CHANGEDフラグを設定しました。
CPSUICB_ACTION_REINIT_ITEMS コールバック関数は、関連付けられた OPTTYPE または OPTPARAM 構造体の Flags または pData メンバーが変更されたことを示すために、OPTITEM 構造体に OPTIF_CHANGED フラグを設定しました。

解説

_CPSUICALLBACK関数型を使用して指定されたコールバック関数は、 CPSUI を使用してプロパティ シート ページを管理するアプリケーションによって提供されます。 これらのコールバック関数のいずれかがプロパティ シート ページに関連付けられている場合、CPSUI は、ユーザー アクティビティ (ページのコントロール フォーカスの変更、オプション値の変更、OK のクリックなど) が検出されたときに呼び出 します

_CPSUICALLBACK型指定コールバック関数は、COMPROPSHEETUI 構造体にアドレスを含めることでプロパティ シート ページに割り当てられます。これは、関数コードがCPSFUNC_ADD_PCOMPROPSHEETUIされるときに CPSUI の ComPropSheet 関数に渡されます。

さらに、 EXTPUSH 構造体を使用して、拡張プッシュ ボタンにコールバック関数を割り当てることができます。

これらのコールバック関数のいずれかが呼び出されると、 CPSUICBPARAM 構造体へのポインターを受け取ります。 この構造体は、ページの現在のオプション設定を記述し、関数を呼び出す原因となったユーザー イベントを示します。 コールバック関数は、設定の検証と処理を行います。 設定 (または設定の組み合わせ) が無効な場合は、ダイアログ ボックスが表示されます。 関数の戻り値は、ページを再表示または再初期化する必要があるかどうかを CPSUI に示します。

DLGPAGE 構造体の DlgProc メンバーがアプリケーション提供のダイアログ ボックス プロシージャを指定している場合、この関数型で指定されたコールバック関数を使用できません。 これは、_CPSUICALLBACK型指定のコールバックは CPSUI のダイアログ ボックス プロシージャから呼び出されるためです。これは、アプリケーションが独自のプロシージャを提供する場合は使用されません。

必要条件

   
対象プラットフォーム デスクトップ
Header compstui.h (Compstui.h を含む)