Metodo IShellPropSheetExt::AddPages (shobjidl_core.h)

Articolo
03/05/2024

Aggiunge una o più pagine a un foglio delle proprietà visualizzato da Shell per un oggetto file. Shell chiama questo metodo per ogni gestore del foglio di proprietà registrato nel tipo di file.

Sintassi

HRESULT AddPages(
  [in] LPFNSVADDPROPSHEETPAGE pfnAddPage,
  [in] LPARAM                 lParam
);

Parametri

[in] pfnAddPage

Tipo: LPFNADDPROPSHEETPAGE

Puntatore a una funzione che il gestore del foglio delle proprietà chiama per aggiungere una pagina al foglio delle proprietà. La funzione accetta un handle del foglio delle proprietà restituito dalla funzione CreatePropertySheetPage e il parametro lParam passato a questo metodo.

[in] lParam

Tipo: LPARAM

Dati specifici del gestore da passare alla funzione puntata da pfnAddPage.

Valore restituito

Tipo: HRESULT

In caso di esito positivo, restituisce un indice basato su uno per specificare la pagina che deve essere visualizzata inizialmente. Per ulteriori informazioni, vedere la sezione Osservazioni.

Commenti

Per ogni pagina che il gestore del foglio delle proprietà deve aggiungere a un foglio di proprietà, il gestore riempie una struttura PROPSHEETPAGE , chiama la funzione CreatePropertySheetPage e quindi chiama la funzione puntata da pfnAddPage.

Il tipo di puntatore della funzione LPFNADDPROPSHEETPAGE è definito in Prsht.h, come illustrato di seguito. Accetta un handle per una struttura PROPSHEETPAGE e i dati definiti dalla funzione tramite lParam.

typedef BOOL (* LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM);

È possibile richiedere tramite l'implementazione che venga visualizzata prima una determinata pagina del foglio delle proprietà anziché la pagina predefinita. A tale scopo, restituire l'indice in base uno della pagina desiderata rispetto alle pagine aggiunte. Ad esempio, se sono state aggiunte tre pagine del foglio delle proprietà, A, B e C e si desidera che B sia la pagina selezionata, il valore restituito deve essere 2. Si noti che questo valore restituito è solo una richiesta. Il foglio delle proprietà potrebbe comunque visualizzare la pagina predefinita.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Condividi tramite