struktur INSERTPSUIPAGE_INFO (compstui.h)

Artikel
08/07/2023

Struktur INSERTPSUIPAGE_INFO digunakan sebagai parameter input untuk fungsi ComPropSheet CPSUI, jika kode fungsi CPSFUNC_INSERT_PSUIPAGE. Semua nilai anggota harus disediakan oleh pemanggil ComPropSheet .

Sintaks

typedef struct _INSERTPSUIPAGE_INFO {
  WORD      cbSize;
  BYTE      Type;
  BYTE      Mode;
  ULONG_PTR dwData1;
  ULONG_PTR dwData2;
  ULONG_PTR dwData3;
} INSERTPSUIPAGE_INFO, *PINSERTPSUIPAGE_INFO;

Anggota

cbSize

Ukuran yang disediakan penelepon, dalam byte, dari struktur INSERTPSUIPAGE_INFO.

Type

Nilai bilangan bulat yang disediakan penelepon yang menunjukkan jenis penyisipan yang diminta. Anggota dapat berisi salah satu konstanta berikut:

PSUIPAGEINSERT_DLL

CPSUI memanggil fungsi jenis PFNPROPSHEETUI yang ditentukan, dengan nilai alasan PROPSHEETUI_REASON_INIT. Fungsi ini terkandung dalam DLL terpisah.

PSUIPAGEINSERT_GROUP_PARENT

CPSUI membuat induk grup baru.

PSUIPAGEINSERT_HPROPSHEETPAGE

CPSUI menyisipkan halaman yang telah dibuat dengan memanggil CreatePropertySheetPage.

(Ini setara dengan memanggil ComPropSheet dengan kode fungsi CPSFUNC_ADD_HPROPSHEETPAGE.)

PSUIPAGEINSERT_PCOMPROPSHEETUI

CPSUI menyisipkan halaman yang dijelaskan oleh struktur COMPROPSHEETUI .

(Ini setara dengan memanggil ComPropSheet dengan kode fungsi CPSFUNC_ADD_PCOMPROPSHEETUI.)

PSUIPAGEINSERT_PFNPROPSHEETUI

CPSUI memanggil fungsi jenis PFNPROPSHEETUI yang ditentukan, dengan nilai alasan PROPSHEETUI_REASON_INIT.

(Ini setara dengan memanggil ComPropSheet dengan kode fungsi CPSFUNC_ADD_PFNPROPSHEETUI.)

PSUIPAGEINSERT_PROPSHEETPAGE

CPSUI menyisipkan halaman yang dijelaskan oleh struktur PROPSHEETPAGE yang ditentukan.

(Ini setara dengan memanggil ComPropSheet dengan kode fungsi CPSFUNC_ADD_PROPSHEETPAGE.)

Mode

Nilai yang disediakan penelepon menunjukkan di mana CPSUI harus menyisipkan halaman baru. Ini harus menjadi salah satu nilai berikut:

INSPSUIPAGE_MODE_AFTER

CPSUI menyisipkan halaman setelah halaman yang diidentifikasi oleh handel halaman CPSUI yang ditentukan oleh parameter lParam1 ke ComPropSheet.

INSPSUIPAGE_MODE_BEFORE

CPSUI menyisipkan halaman sebelum halaman diidentifikasi oleh handel halaman CPSUI yang ditentukan oleh parameter lParam1 ke ComPropSheet.

INSPSUIPAGE_MODE_FIRST_CHILD

CPSUI menyisipkan halaman sebagai turunan pertama dari grup induk yang diidentifikasi oleh parameter hComPropSheet ke ComPropSheet.

Parameter lParam1 ke ComPropSheet diabaikan.

INSPUIPAGE_MODE_INDEX

CPSUI menyisipkan halaman sebagai turunan dari grup induk yang diidentifikasi oleh parameter hComPropSheet ke ComPropSheet.

Parameter lParam1 ke ComPropSheet menentukan indeks berbasis nol yang mengidentifikasi di mana, dalam kumpulan turunan, halaman yang ditentukan harus disisipkan. Jika lParam1 adalah 0, halaman disisipkan mulai dari halaman 1; jika lParam1 adalah 1, halaman disisipkan mulai dari halaman 2; dan sebagainya. Jika indeks lebih besar dari jumlah anak yang ada, halaman baru ditambahkan sebagai anak terakhir. Nilai lParam1 harus ditentukan sebagai HINSPSUIPAGE_INDEX(indeks).

INSPSUIPAGE_MODE_LAST_CHILD

CPSUI menyisipkan halaman sebagai turunan terakhir dari grup induk yang diidentifikasi oleh parameter hComPropSheet ke ComPropSheet.

Parameter lParam1 ke ComPropSheet diabaikan.

dwData1

Lihat bagian Keterangan di bawah ini.

dwData2

Lihat bagian Keterangan di bawah ini.

dwData3

Lihat bagian Keterangan di bawah ini.

Keterangan

Anggota dwData1, dwData2, dan dwData3 berisi nilai yang disediakan pemanggil yang bergantung pada konten anggota Jenis , sebagai berikut:

Anggota tipe berisi PSUIPAGEINSERT_DLL

dwData1 - Penunjuk yang disediakan penelepon ke string yang dihentikan NULL yang mewakili nama jalur DLL.

dwData2 - Penunjuk yang disediakan penelepon ke string yang dihentikan NULL yang mewakili nama fungsi berjenis PFNPROPSHEETUI , yang terkandung dalam DLL yang ditentukan.

dwData3 - Nilai 32-bit yang disediakan penelepon, diteruskan ke fungsi jenis PFNPROPSHEETUI untuk parameter lParam-nya .