IWizardExtension::AddPages メソッド (shobjidl.h)

ページを表す PROPSHEETPAGE 構造体にハンドルを配列に入力して、ウィザードに拡張ページを追加します。

構文

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

パラメーター

[out] aPages

種類: HPROPSHEETPAGE*

ウィザード ダイアログ ページを表す PROPSHEETPAGE ハンドルの配列へのポインター。 拡張ページの PROPSHEETPAGE 構造体へのハンドルがこの配列に追加されます。

[in] cPages

型: UINT

aPages 内の要素の数。

[out] pnPagesAdded

種類: UINT*

ハンドルの数が正常に追加されました。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

aPages が指すハンドルの配列には、拡張ページの前後にあるウィザード ダイアログ ページへのハンドルを含めることができます。 配列のポインターをこのメソッドに渡して、その値が最初の空の配列要素になるようにする必要があります。最初の要素ではなく、最初の拡張ページのハンドルを受け入れる準備が整います。 cPages で渡される値は、合計数ではなく未使用の配列要素の数を示す必要があります。

たとえば、 hpages という名前の配列に 2 つの入門ホスト ページが追加された場合、 IWizardExtension::AddPages の呼び出しは次のように表示されます。

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

PROPSHEETPAGE 構造体であるウィザード ページとホストされた HTML ページを混同しないでください。 1 つのウィザード ダイアログ ページで、多数のシーケンシャル HTML ページをホストできます。 このメソッドは、ウィザード拡張機能によって追加されたウィザード ダイアログ ページの数を提供します。サーバー側の HTML ページの数は表示されません。

要件