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 |