次の方法で共有

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

  • [アーティクル]

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

構文

_CPSUICALLBACK Cpsuicallback;

LONG Cpsuicallback(
  PCPSUICBPARAM pCPSUICBParam
)
{...}

パラメーター

pCPSUICBParam

CPSUI が提供する、CPSUICBPARAM 構造体へのポインター。

戻り値

_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 コールバック関数は、OPTITEM 構造体に OPTIF_CHANGED フラグを設定して、選択したオプションが変更されたか、または別のOPTUF プレフィックス付きフラグが変更されたことを示しています。
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 のダイアログ ボックス プロシージャから呼び出されるためです。これは、アプリケーションが独自のプロシージャを提供する場合には使用されません。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー compstui.h (Compstui.h を含む)