Struktur CPSUICBPARAM (compstui.h)

Artikel
07/16/2024

Struktur CPSUICBPARAM digunakan sebagai parameter input untuk _CPSUICALLBACKfungsi panggilan balik yang diketik.

Sintaksis

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;

Anggota

cbSize

Ukuran yang disediakan CPSUI, dalam byte, dari struktur CPSUICBPARAM.

Reason

Nilai yang disediakan CPSUI menunjukkan alasannya memanggil fungsi panggilan balik. Ini bisa menjadi salah satu nilai berikut:

CPSUICB_REASON_ABOUT

Pengguna telah mengklik tombol Tentang halaman, dan aplikasi sebelumnya mengatur bendera CPSUIF_ABOUT_CALLBACK dalam struktur COMPROPSHEETUI . CPSUI menetapkan pCurItem ke nilai yang terkandung dalam pOptItem, dan mengatur pOldSel untuk menunjuk ke struktur COMPROPSHEETUI.

CPSUICB_REASON_APPLYNOW

Pengguna telah mengeklik tombol Terapkan halaman atau OK, dan CPSUI telah menerima pesan pemberitahuan PSN_APPLY. CPSUI mengatur pCurItem untuk menunjuk ke opsi yang titik pOptItem. Ini juga mengatur OldSel ke minus satu untuk menunjukkan bahwa semua nilai opsi yang diubah yang valid harus diterapkan sekarang.

CPSUICB_REASON_DLGPROC

Opsi yang diidentifikasi oleh pCurItem adalah tombol tekan (jenis opsiTVOT_PUSHBUTTON), dan pengguna telah mengklik tombol .

Bidang Gaya OPTPARAM opsi disetel ke PUSHBUTTON_TYPE_DLGPROC.

CPSUICB_REASON_ECB_CHANGED

Opsi yang diidentifikasi oleh pCurItem adalah kotak centang yang diperluas, dan pengguna telah mengubah status kotak.

CPSUICB_REASON_EXTPUSH

Opsi yang diidentifikasi oleh pCurItem adalah tombol tekan yang diperluas, dan pengguna telah mengklik tombol .

CPSUICB_REASON_ITEMS_REVERTED

Pengguna mengklik tombol Batalkan halaman, dan CPSUI telah mengembalikan semua pilihan ke nilai aslinya.

CPSUICB_REASON_KILLACTIVE

Halaman lembar properti akan kehilangan aktivasi, dan CPSUI telah menerima pesan pemberitahuan PSN_KILLACTIVE. CPSUI menetapkan pCurItem ke nilai yang terkandung dalampOptItem , dan mengatur pOldSel untuk menunjuk ke struktur COMPROPSHEETUI .

CPSUICB_REASON_OPTITEM_SETFOCUS

Opsi yang diidentifikasi oleh pCurItem telah menerima fokus input.

CPSUICB_REASON_PUSHBUTTON

Opsi yang diidentifikasi oleh pCurItem adalah tombol tekan (jenis opsiTVOT_PUSHBUTTON), dan pengguna telah mengklik tombol .

Bidang GayaOPTPARAM item disetel ke PUSHBUTTON_TYPE_CALLBACK.

CPSUICB_REASON_SEL_CHANGED

Pengguna telah mengubah nilai yang dipilih untuk opsi yang ditunjukkan oleh pCurItem.

CPSUICB_REASON_SETACTIVE

Halaman lembar properti akan menjadi aktif, dan CPSUI telah menerima pesan pemberitahuan PSN_SETACTIVE. CPSUI menetapkan pCurItem ke nilai yang terkandung dalampOptItem , dan mengatur pOldSel untuk menunjuk ke struktur COMPROPSHEETUI .

hDlg

Handel yang disediakan CPSUI ke kotak dialog yang saat ini aktif.

pOptItem

Pointer yang disediakan CPSUI ke array struktur OPTITEM . Ini adalah pointer yang sama dengan yang sebelumnya disediakan aplikasi dalam struktur COMPROPSHEETUI .

cOptItem

Jumlah struktur OPTITEM yang disediakan CPSUI dalam array yang ditunjukkan oleh pOptItem. Ini adalah angka yang sama dengan yang sebelumnya disediakan aplikasi dalam struktur COMPROPSHEETUI .

Flags

Bendera yang disediakan CPSUI. Ini adalah set bendera yang sama dengan yang sebelumnya disediakan aplikasi dalam struktur COMPROPSHEETUI.

pCurItem

Penunjuk yang disediakan CPSUI kepada anggota array OPTITEM yang ditujukkan oleh pOptItem. Anggota array ini mewakili opsi "saat ini", yang merupakan salah satu yang fungsi panggilan baliknya dipanggil.

DUMMYUNIONNAME

Menentukan penyatuan DUMMYUNIONNAME .

DUMMYUNIONNAME.OldSel

Jika anggota Alasan berisi CPSUICB_REASON_SEL_CHANGED, CPSUI mengatur penyatuan ini ke konten sebelumnya dari OldSelpOldSel anggota struktur OPTITEM yang ditunjukkan oleh pCurItem.

Untuk semua nilai Alasan lainnya, konten serikat ini harus diabaikan.

DUMMYUNIONNAME.pOldSel

Jika anggota Alasan berisi CPSUICB_REASON_SEL_CHANGED, CPSUI mengatur penyatuan ini ke konten sebelumnya dari OldSelpOldSel anggota struktur OPTITEM yang ditunjukkan oleh pCurItem.

Untuk semua nilai Alasan lainnya, konten serikat ini harus diabaikan.

UserData

Data pengguna yang disediakan CPSUI. Ini adalah nilai yang sama dengan yang sebelumnya disediakan aplikasi dalam struktur COMPROPSHEETUI .

Result

Nilai hasil yang disediakan oleh fungsi panggilan balik _CPSUICALLBACK-typed. Secara default, CPSUI mengatur nilai ini ke CPSUI_OK. Setelah fungsi panggilan balik kembali, CPSUI memanggil fungsi ComPropSheet dengan kode fungsi CPSFUNC_SET_RESULT, menyediakan Reason konten anggota sebagai nilai hasil.

Anggota ini hanya digunakan jika anggota Alasan CPSUICB_REASON_APPLYNOW dan fungsi panggilan balik tidak mengembalikan CPSUI_ACTION_NO_APPLY_EXIT.

Persyaratan

Syarat	Nilai
Header	compstui.h (termasuk Compstui.h)

Bagikan melalui