CPSUICBPARAM 構造体 (compstui.h)

[アーティクル]
07/16/2024

CPSUICBPARAM 構造体は、型指定されたコールバック関数を _CPSUICALLBACKするための入力パラメーターとして使用されます。

構文

typedef struct _CPSUICBPARAM {
  WORD      cbSize;
  WORD      Reason;
  HWND      hDlg;
  POPTITEM  pOptItem;
  WORD      cOptItem;
  WORD      Flags;
  POPTITEM  pCurItem;
  union {
    LONG   OldSel;
    LPTSTR pOldSel;
  } DUMMYUNIONNAME;
  ULONG_PTR UserData;
  ULONG_PTR Result;
} CPSUICBPARAM, *PCPSUICBPARAM;

メンバーズ

cbSize

CPSUICBPARAM 構造体の CPSUI 指定サイズ (バイト単位)。

Reason

コールバック関数を呼び出す理由を示す CPSUI 提供の値。次のいずれかの値を指定できます。

CPSUICB_REASON_ABOUT

ユーザーは、ページの [バージョン情報] ボタンをクリックし、アプリケーションは以前に COMPROPSHEETUI 構造体でCPSUIF_ABOUT_CALLBACK フラグを設定しました。 CPSUI は pCurItem pOptItemに含まれる値設定し、COMPROPSHEETUI 構造体を指すように pOldSel 設定します。

CPSUICB_REASON_APPLYNOW

ユーザーがページの [ の適用] または [OK] ボタンクリックすると、CPSUI に PSN_APPLY 通知メッセージが表示されます。 CPSUI は pCurItem pOptItem ポイントするオプションポイントするように設定します。また、OldSel をマイナス 1 に設定して、すべての有効な変更されたオプション値を今すぐ適用する必要があることを示します。

CPSUICB_REASON_DLGPROC

pCurItem で識別されるオプションは、プッシュボタン (オプションの種類TVOT_PUSHBUTTON) であり、ユーザーはそのボタンをクリックしました。

プッシュボタンオプションの OPTPARAM Style フィールドは、PUSHBUTTON_TYPE_DLGPROCに設定されます。

CPSUICB_REASON_ECB_CHANGED

pCurItem で識別されるオプションは拡張チェックボックスであり、ユーザーはボックスの状態を変更しました。

CPSUICB_REASON_EXTPUSH

pCurItem で識別されるオプションは拡張プッシュボタンであり、ユーザーはそのボタンをクリックしました。

CPSUICB_REASON_ITEMS_REVERTED

ユーザーがページの [元に戻す] ボタンをクリックすると、CPSUI はすべての選択内容を元の値に戻しました。

CPSUICB_REASON_KILLACTIVE

プロパティシートページのアクティブ化が失われようとしており、CPSUI は PSN_KILLACTIVE 通知メッセージを受信しました。 CPSUI は pCurItem pOptItemに含まれる値設定し、COMPROPSHEETUI 構造体を指すように pOldSel 設定します。

CPSUICB_REASON_OPTITEM_SETFOCUS

pCurItem によって識別されるオプションは、入力フォーカスを受け取りました。

CPSUICB_REASON_PUSHBUTTON

pCurItem で識別されるオプションは、プッシュボタン (オプションの種類TVOT_PUSHBUTTON) であり、ユーザーはそのボタンをクリックしました。

プッシュボタン項目の OPTPARAMStyle フィールドは、PUSHBUTTON_TYPE_CALLBACKに設定されます。

CPSUICB_REASON_SEL_CHANGED

ユーザーは、pCurItemによって示されるオプション選択した値を変更しました。

CPSUICB_REASON_SETACTIVE

プロパティシートページがアクティブになり、CPSUI が PSN_SETACTIVE 通知メッセージを受信しました。 CPSUI は pCurItem pOptItemに含まれる値設定し、COMPROPSHEETUI 構造体を指すように pOldSel 設定します。

hDlg

現在アクティブなダイアログボックスへの CPSUI 提供のハンドル。

pOptItem

OPTITEM 構造体の配列への CPSUI 提供のポインター。これは、アプリケーションが以前に COMPROPSHEETUI 構造体で指定したポインターと同じです。

cOptItem

pOptItemが指す配列内の CPSUI 指定の OPTITEM 構造体数。これは、アプリケーションが以前に COMPROPSHEETUI 構造体で指定したのと同じ番号です。

Flags

CPSUI によって提供されるフラグ。これは、アプリケーションが以前に COMPROPSHEETUI 構造体で指定したのと同じフラグのセットです。

pCurItem

pOptItemが指す OPTITEM 配列のメンバー CPSUI によって提供されるポインター。この配列メンバーは、コールバック関数が呼び出された "current" オプションを表します。

DUMMYUNIONNAME

DUMMYUNIONNAME 共用体を定義します。

DUMMYUNIONNAME.OldSel

Reason メンバーにCPSUICB_REASON_SEL_CHANGEDが含まれている場合、CPSUI はこの共用体を、pCurItemが指す OPTITEM 構造体の OldSelpOldSel メンバーの前の内容設定します。

その他のすべての理由値については、この共用体の内容は無視する必要があります。

DUMMYUNIONNAME.pOldSel

その他のすべての理由値については、この共用体の内容は無視する必要があります。

UserData

CPSUI が提供するユーザーデータ。これは、アプリケーションが以前に COMPROPSHEETUI 構造体で指定した値と同じです。

Result

_CPSUICALLBACK型指定コールバック関数によって提供される結果値。既定では、CPSUI はこの値を CPSUI_OK に設定します。コールバック関数が戻った後、CPSUI は ComPropSheet 関数を CPSFUNC_SET_RESULTの関数コードと共に呼び出し、結果値として Reason メンバーの内容を指定します。

このメンバーは、Reason メンバーがCPSUICB_REASON_APPLYNOWされ、コールバック関数がCPSUI_ACTION_NO_APPLY_EXITを返さない場合にのみ使用されます。

必要条件

要件	価値
ヘッダー	compstui.h (Compstui.h を含む)

次の方法で共有