Condividi tramite


Metodo IWizardExtension::AddPages (shobjidl.h)

Aggiunge le pagine di estensione alla procedura guidata riempiendo una matrice con handle alle strutture PROPSHEETPAGE che rappresentano tali pagine.

Sintassi

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

Parametri

[out] aPages

Tipo: HPROPSHEETPAGE*

Puntatore a una matrice di handle PROPSHEETPAGE che rappresentano le pagine della finestra di dialogo della procedura guidata. Gli handle delle strutture PROPSHEETPAGE per le pagine di estensione vengono aggiunti a questa matrice.

[in] cPages

Tipo: UINT

Numero di elementi in aPages.

[out] pnPagesAdded

Tipo: UINT*

Numero di handle aggiunti correttamente.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La matrice di handle puntati da apages può contenere handle per le pagine della finestra di dialogo della procedura guidata precedenti e seguendo le pagine di estensione. Il puntatore della matrice deve essere passato a questo metodo in modo che il relativo valore sia il primo elemento matrice vuoto, pronto per accettare l'handle della prima pagina di estensione, anziché semplicemente il primo elemento. In modo collaterale, il valore passato in cPages deve stato il numero di elementi della matrice inutilizzati anziché il numero totale.

Ad esempio, se due pagine host introduttive sono state aggiunte a una matrice denominata hpages, la chiamata a IWizardExtension::AddPages verrà visualizzata come indicato di seguito.

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

Non confondere le pagine della procedura guidata, ovvero strutture PROPSHEETPAGE , con pagine HTML ospitate. Una pagina della finestra di dialogo della procedura guidata può ospitare molte pagine HTML sequenziali. Questo metodo fornisce il numero di pagine della finestra di dialogo della procedura guidata aggiunte dall'estensione della procedura guidata, non il numero di pagine HTML lato server visualizzate in esso.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shobjidl.h
DLL Shell32.dll