Metode IWizardExtension::AddPages (shobjidl.h)

Artikel
08/26/2023

Menambahkan halaman ekstensi ke wizard dengan mengisi array dengan handel ke struktur PROPSHEETPAGE yang mewakili halaman tersebut.

Sintaks

HRESULT AddPages(
  [out] HPROPSHEETPAGE *aPages,
  [in]  UINT           cPages,
  [out] UINT           *pnPagesAdded
);

Parameter

[out] aPages

Jenis: HPROPSHEETPAGE*

Penunjuk ke array handel PROPSHEETPAGE yang mewakili halaman dialog wizard. Handel ke struktur PROPSHEETPAGE untuk halaman ekstensi ditambahkan ke array ini.

[in] cPages

Jenis: UINT

Jumlah elemen dalam aPages.

[out] pnPagesAdded

Jenis: UINT*

Jumlah handel berhasil ditambahkan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Array handel yang ditunjukkan oleh aPages dapat berisi handel ke halaman dialog wizard sebelumnya dan mengikuti halaman ekstensi. Penunjuk array harus diteruskan ke metode ini sehingga nilainya adalah elemen array kosong pertama, siap untuk menerima handel halaman ekstensi pertama, bukan hanya elemen pertama. Secara kolateral, nilai yang diteruskan dalam cPages harus menyatakan jumlah elemen array yang tidak digunakan alih-alih jumlah total.

Misalnya, jika dua halaman host pengantar ditambahkan ke array yang disebut hpages, maka panggilan ke IWizardExtension::AddPages akan muncul sebagai berikut.

#define ARRAYSIZE(a)    (sizeof(a)/sizeof(a[0]))
g_iwe->AddPages(&hpages[2], ARRAYSIZE(hpages)-2, &nPages);

Jangan membingungkan halaman wizard, yang merupakan struktur PROPSHEETPAGE , dengan halaman HTML yang dihosting. Satu halaman dialog wizard dapat menghosting banyak halaman HTML berurutan. Metode ini menyediakan jumlah halaman dialog wizard yang ditambahkan oleh ekstensi wizard, bukan jumlah halaman HTML sisi server yang ditampilkan di dalamnya.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl.h
DLL	Shell32.dll

Share via