IWizardExtension

Web 発行ウィザードやオンライン印刷注文ウィザードなど、サーバー側のコンテンツ ページをホストするウィザードで使用されます。このインターフェイスは、サポートする拡張ページを指定し、それらのページへの移動および移動元への復帰を行うメソッドを公開します。

それらのページを表す PROPSHEETPAGE 構造体のハンドルで配列を埋めることにより、ウィザードに拡張ページを追加します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

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

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

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

ウィザード ページ(PROPSHEETPAGE 構造体)を、ホストされる HTML ページと混同しないでください。1 つのウィザード ダイアログ ページは、複数の連続した HTML ページをホストできます。このメソッドが提供するのは、ウィザード拡張によって追加されるウィザード ダイアログ ページの数であり、その中に表示されるサーバー側 HTML ページの数ではありません。

ウィザード拡張の最初のページへのハンドルを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

ウィザード拡張は複数の連続した HTML ページをホストできますが、ページが 1 つのみで構成される場合は、IWizardExtension::GetFirstPage と IWizardExtension::GetLastPage が返すハンドルは同じになります。

ウィザード拡張ページの最終ページへのハンドルを取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

この値は、ユーザーが 戻る ボタンをクリックしたときに、ウィザード拡張ページへ後方に移動するために使用されます。

ウィザード拡張は複数の連続した HTML ページをホストできますが、ページが 1 つのみで構成される場合は、IWizardExtension::GetFirstPage と IWizardExtension::GetLastPage が返すハンドルは同じになります。